-
-
29 May 2009 00:50:00 UTC
- Distribution: PerlIO-fse
- Module version: 0.02
- Source (raw)
- Browse (raw)
- Changes
- How to Contribute
- Issues (0)
- Testers (568 / 6 / 11)
- Kwalitee
Bus factor: 1- 90.91% Coverage
- License: perl_5
- Perl: v5.8.1
- Activity
24 month- Tools
- Download (31.48KB)
- MetaCPAN Explorer
- Permissions
- Subscribe to distribution
- Permalinks
- This version
- Latest version
and 1 contributors- Goro Fuji (藤 吾郎) <gfuji (at) cpan.org>.
- Dependencies
- Encode
- and possibly others
- Reverse dependencies
- CPAN Testers List
- Dependency graph
NAME
PerlIO::fse - Deals with Filesystem Encoding
SYNOPSIS
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';
DESCRIPTION
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
attempts to get the filesystem encoding(fse
) from$ENV{PERLIO_FSE}
, and if defined, it will be used. Or you canuse PerlIO::fse $encoding
directive to setfse
.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.This layer uses
Encode
internally to convert encodings.METHODS
PerlIO::fse->get_fse()
PerlIO::fse->set_fse($encoding)
HISTORY
This module started in a part of
PerlIO::Util
, but now is an independent distribution. There are two reasons for this.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
.SEE ALSO
AUTHOR
Goro Fuji (藤 吾郎) <gfuji (at) cpan.org>.
LICENSE AND COPYRIGHT
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.
Module Install Instructions
To install PerlIO::fse, copy and paste the appropriate command in to your terminal.
cpanm PerlIO::fse
perl -MCPAN -e shell install PerlIO::fse
For more information on module installation, please visit the detailed CPAN module installation guide.