NAME
Config::Maker::Encode - Wrapper for Encode and PerlIO::encoding
SYNOPSIS
use Config::Maker::Encode
$localtext = encode('system', $test);
$text = decode('system', $localtext);
encmode FH, 'system';
DESCRIPTION
This module exports three functions, encode
, decode
and encmode
. The encode
and decode
functions work like their counterparts from Encode. The encmode
function is a wrapper around binmode
core function, that sets :encoding($encoding)
layer.
These functions degrade gracefuly to nops, if not all of the recoding infrastructure is available, as is the case with perl 5.6, printing a warning if non-default operation was requested (where non-default means different from system
).
Additionaly, a system
encoding alias is defined to whatever I18N::Langinfo
reports as a locale encoding (falling back to ascii
if that encoding is not supported by perl).
To fully support recoding, the modules Encode, Encode::Alias, PerlIO::encoding and I18N::Langinfo must be available. If they are not, dummy replacements are used as described above. In that case, Config::Maker
will only work when all files are in the same default encoding and non-ascii characters won't work in identifiers (since the data can't be internaly translated to unicode).
AUTHOR
Jan Hudec <bulb@ucw.cz>
COPYRIGHT AND LICENSE
Copyright 2004 Jan Hudec. All rights reserved.
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
SEE ALSO
configit(1), perl(1), Config::Maker(3pm), Encode(3pm), Encode::Alias(3pm), I18N::Langinfo(3pm), PerlIO::encoding(3pm).