The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

PerlIO::text

VERSION

version 0.007

SYNOPSIS

 open my $fh, '<:text(UTF-16LE)', $filename;

DESCRIPTION

This module provides a textual pseudo-layer. Instead of pushing itself, it pushes the right layers to open text files in the specified encoding.

SYNTAX

This modules does not have to be loaded explicitly, it will be loaded automatically by using it in an open mode. The module has the following general syntax: :text(charset). charset is mandatory and without it this module will give an error. Any character-set known to Encode may be given as an argument.

PHILOSPHY

This modules tried to Do The Right Thing™. That means that it won't do the same on all platforms, and that it may do something smarter in the future (such as Unicode normalization).

RATIONALE

At first sight this module may seem merely a wrapper around :encoding, and in fact on unix it pretty much is. Its main reason of existence is that many multibyte encodings are not crlf safe, resulting is issues on Windows. A mode of >:encoding(UTF-16LE) does the wrong thing by doing crlf translation after the UTF-16 encoding, this causes an output that is not valid UTF-16. Instead this module does something along these lines on Windows: >:raw:encoding(UTF-16-LE):crlf, which is correct but horrible from a huffmanization point of view and it adds complexity to your code because now the correct open mode depends on the platform. This module abstracts that complication.

AUTHOR

Leon Timmermans <leont@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2011 by Leon Timmermans.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.