PerlIO::fse - Deals with Filesystem Encoding
use utf8; # for Windows (including Cygwin) open my $in, '<:fse', $file; # Other systems requires explicit fse $ENV{PERLIO_FSE} = 'utf8'; # UTF-8 is default # or use PerlIO::fse 'utf8';
PerlIO::fse mediates encodings between Perl and Filesystem. It converts filenames into native forms if the filenames are utf8-flagged. Otherwise, PerlIO::fse does nothing, looking on it as native forms.
PerlIO::fse
PerlIO::fse attempts to get the filesystem encoding(fse) from $ENV{PERLIO_FSE}, and if defined, it will be used. Or you can use PerlIO::fse $encoding directive to set fse.
fse
$ENV{PERLIO_FSE}
use PerlIO::fse $encoding
If you use Windows (including Cygwin), you need not to set $ENV{PERLIO_FSE} because the current codepage is detected automatically. However, if $ENV{PERLIO_FSE} is set, PerlIO::fse will give it priority.
When there is no encoding available, UTF-8 will be used.
UTF-8
This layer uses Encode internally to convert encodings.
Encode
PerlIO::fse->get_fse()
PerlIO::fse->set_fse($encoding)
This module started in a part of PerlIO::Util, but now is an independent distribution. There are two reasons for this.
PerlIO::Util
First, PerlIO::fse is unstable. I have seen segmentation fault in the test suit in some perls, but could not find what causes the problem. This problem should be resolved.
Second, authough automatic encoding detection is available in Windows system, it can be implemented in non-Windows, and it should be. This feature may require many tests, but I don't want to increment the version of PerlIO::Util.
PerlIO::Util.
Encode.
Goro Fuji (藤 吾郎) <gfuji (at) cpan.org>.
Copyright (c) 2008-2009, Goro Fuji <gfuji (at) cpan.org>. Some rights reserved.
This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
To install PerlIO::fse, copy and paste the appropriate command in to your terminal.
cpanm
cpanm PerlIO::fse
CPAN shell
perl -MCPAN -e shell install PerlIO::fse
For more information on module installation, please visit the detailed CPAN module installation guide.