home *** CD-ROM | disk | FTP | other *** search
/ Netrunner 2004 October / NETRUNNER0410.ISO / regular / ActivePerl-5.8.4.810-MSWin32-x86.msi / _bea0bdbcfc45ecb8e6a6c76de917a648 < prev    next >
Encoding:
Text File  |  2004-06-01  |  1.4 KB  |  85 lines
  1. package DBM_Filter::encode ;
  2.  
  3. use strict;
  4. use warnings;
  5. use Carp;
  6.  
  7. our $VERSION = '0.01';
  8.  
  9. BEGIN
  10. {
  11.     eval { require Encode; };
  12.  
  13.     croak "Encode module not found.\n"
  14.         if $@;
  15. }
  16.  
  17.  
  18. sub Filter
  19. {
  20.     my $encoding_name = shift || "utf8";
  21.  
  22.     my $encoding = Encode::find_encoding($encoding_name) ;
  23.  
  24.     croak "Encoding '$encoding_name' is not available"
  25.         unless $encoding;
  26.  
  27.     return {
  28.         Store   => sub { 
  29.              $_ = $encoding->encode($_) 
  30.                  if defined $_ ;
  31.            },
  32.         Fetch   => sub { 
  33.              $_ = $encoding->decode($_)
  34.                  if defined $_ ;
  35.             }
  36.         } ;
  37. }
  38.  
  39. 1;
  40.  
  41. __END__
  42.  
  43. =head1 DBM_Filter::encode
  44.  
  45. =head1 SYNOPSIS
  46.  
  47.     use SDBM_File; # or DB_File, or GDBM_File, or NDBM_File, or ODBM_File
  48.     use DBM_Filter ;
  49.  
  50.     $db = tie %hash, ...
  51.     $db->Filter_Push('encode' => 'iso-8859-16');
  52.     
  53. =head1 DESCRIPTION
  54.  
  55. This DBM filter allows you to choose the character encoding will be
  56. store in the DBM file. The usage is
  57.  
  58.     $db->Filter_Push('encode' => ENCODING);
  59.  
  60. where "ENCODING" must be a valid encoding name that the Encode module
  61. recognises.
  62.  
  63. A fatal error will be thrown if:
  64.  
  65. =over 5
  66.  
  67. =item 1
  68.  
  69. The Encode module is not available.
  70.  
  71. =item 2
  72.  
  73. The encoding requested is not supported by the Encode module.
  74.  
  75. =back
  76.  
  77. =head1 SEE ALSO
  78.  
  79. L<DBM_Filter>, L<perldbmfilter>, L<Encode>
  80.  
  81. =head1 AUTHOR
  82.  
  83. Paul Marquess pmqs@cpan.org
  84.  
  85.