Upgrade to PerlIO::encoding 0.02, from Dan Kogai.
[p5sagit/p5-mst-13.2.git] / ext / PerlIO / encoding / encoding.pm
1 package PerlIO::encoding;
2 our $VERSION = '0.02';
3 use XSLoader ();
4 use Encode;
5 XSLoader::load 'PerlIO::encoding';
6 1;
7 __END__
8
9 =head1 NAME
10
11 PerlIO::encoding - encoding layer
12
13 =head1 SYNOPSIS
14
15   open($f, "<:encoding(foo)", "infoo");
16   open($f, ">:encoding(bar)", "outbar");
17
18 =head1 DESCRIPTION
19
20 Open a filehandle with a transparent encoding filter.
21
22 On input, convert the bytes expected to be in the specified
23 character set and encoding to Perl string data (Unicode and
24 Perl's internal Unicode encoding, UTF-8).  On output, convert
25 Perl string data into the specified character set and encoding.
26
27 =head1 SEE ALSO
28
29 L<open>, L<Encode>, L<perlfunc/binmode>, L<perluniintro>
30
31 =cut
32
33