[p5sagit/p5-mst-13.2.git] / ext / PerlIO / encoding / encoding.pm

package PerlIO::encoding;
our $VERSION = '0.02';
use XSLoader ();
use Encode;
XSLoader::load 'PerlIO::encoding';
1;
__END__

=head1 NAME

PerlIO::encoding - encoding layer

=head1 SYNOPSIS

  open($f, "<:encoding(foo)", "infoo");
  open($f, ">:encoding(bar)", "outbar");

=head1 DESCRIPTION

Open a filehandle with a transparent encoding filter.

On input, convert the bytes expected to be in the specified
character set and encoding to Perl string data (Unicode and
Perl's internal Unicode encoding, UTF-8).  On output, convert
Perl string data into the specified character set and encoding.

=head1 SEE ALSO

L<open>, L<Encode>, L<perlfunc/binmode>, L<perluniintro>

=cut
Commit	Line	Data
59035dcc	1	package PerlIO::encoding;
918951dd	2	our $VERSION = '0.02';
59035dcc	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
b89cebd3	15	open($f, "<:encoding(foo)", "infoo");
b89cebd3	16	open($f, ">:encoding(bar)", "outbar");
59035dcc	17
	18	=head1 DESCRIPTION
	19
b89cebd3	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>
2dc05cb3	30
59035dcc	31	=cut
	32
	33