NAME

   Encode::Simple - Encode and decode text, simply

SYNOPSIS

     use Encode::Simple qw(encode decode encode_lax decode_lax);
     my $characters = decode 'cp1252', $bytes;
     my $characters = decode_lax 'UTF-8', $bytes;
     my $bytes = encode 'Shift_JIS', $characters;
     my $bytes = encode_lax 'ASCII', $characters;

DESCRIPTION

   This module is a simple wrapper around Encode that presents "encode"
   and "decode" functions with straightforward behavior and error
   handling. See Encode::Supported for a list of supported encodings.

FUNCTIONS

   All functions are exported by name, as well as via the tags :all,
   :strict, and :lax. By default, "encode" and "decode" are exported.

encode

     my $bytes = encode $encoding, $characters;

   Encodes the input string of characters into a byte string using
   $encoding. Throws an exception if the input string contains characters
   that are not valid or possible to represent in $encoding.

encode_lax

     my $bytes = encode_lax $encoding, $characters;

   Encodes the input string of characters as in "encode", but instead of
   throwing an exception on invalid input, any invalid characters are
   encoded as a substitution character (the substitution character used
   depends on the encoding). Note that some encoders do not respect this
   option and may throw an exception anyway, this notably includes
   Encode::Unicode (but not UTF-8).

decode

     my $characters = decode $encoding, $bytes;

   Decodes the input byte string into a string of characters using
   $encoding. Throws an exception if the input bytes are not valid for
   $encoding.

decode_lax

     my $characters = decode_lax $encoding, $bytes;

   Decodes the input byte string as in "decode", but instead of throwing
   an exception on invalid input, any malformed bytes will be decoded to
   the Unicode replacement character (U+FFFD). Note that some encoders do
   not respect this option and may throw an exception anyway, this notably
   includes Encode::Unicode (but not UTF-8).

BUGS

   Report any issues on the public bugtracker.

AUTHOR

   Dan Book <[email protected]>

COPYRIGHT AND LICENSE

   This software is Copyright (c) 2018 by Dan Book.

   This is free software, licensed under:

     The Artistic License 2.0 (GPL Compatible)

SEE ALSO

   Unicode::UTF8

You are viewing proxied material from ftp.icm.edu.pl. The copyright of proxied material belongs to its original authors. Any comments or complaints in relation to proxied material should be directed to the original authors of the content concerned. Please see the disclaimer for more details.