PICONV(1) Perl Programmers Reference Guide PICONV(1)

NAME
       piconv - iconv(1), reinvented in perl

SYNOPSIS
         piconv [-f fromencoding] [-t toencoding] [-s string] [files...]
         piconv -l
         piconv [-C N|-c|-p]
         piconv -S scheme ...
         piconv -r encoding
         piconv -D ...
         piconv -h

DESCRIPTION
       ppiiccoonnvv is perl version of iiccoonnvv, a character encoding converter widely
       available for various Unixen today.  This script was primarily a tech-
       nology demonstrator for Perl 5.8.0, but you can use piconv in the place
       of iconv for virtually any case.

       piconv converts the character encoding of either STDIN or files speci-
       fied in the argument and prints out to STDOUT.

       Here is the list of options.  Each option can be in short format (-f)
       or long (-from).

       -f,-from fromencoding
           Specifies the encoding you are converting from.  Unlike iiccoonnvv, this
           option can be omitted.  In such cases, the current locale is used.

       -t,-to toencoding
           Specifies the encoding you are converting to.  Unlike iiccoonnvv, this
           option can be omitted.  In such cases, the current locale is used.

           Therefore, when both -f and -t are omitted, ppiiccoonnvv just acts like
           ccaatt.

       -s,-string string
           uses string instead of file for the source of text.

       -l,-list
           Lists all available encodings, one per line, in case-insensitive
           order.  Note that only the canonical names are listed; many aliases
           exist.  For example, the names are case-insensitive, and many stan-
           dard and common aliases work, such as "latin1" for "ISO-8859-1", or
           "ibm850" instead of "cp850", or "winlatin1" for "cp1252".  See
           Encode::Supported for a full discussion.

       -C,-check N
           Check the validity of the stream if N = 1.  When N = -1, something
           interesting happens when it encounters an invalid character.

       -c  Same as "-C 1".

       -p,-perlqq
           Same as "-C -1".

       -h,-help
           Show usage.

       -D,-debug
           Invokes debugging mode.  Primarily for Encode hackers.

       -S,-scheme scheme
           Selects which scheme is to be used for conversion.  Available
           schemes are as follows:

           fromto
               Uses Encode::fromto for conversion.  This is the default.

           decodeencode
               Input strings are decode()d then encode()d.  A straight two-
               step implementation.

           perlio
               The new perlIO layer is used.  NI-S' favorite.

           Like the -D option, this is also for Encode hackers.

SEE ALSO
       "1" in iconv "3" in locale Encode Encode::Supported Encode::Alias Per-
       lIO



perl v5.8.6                       2009-01-12                         PICONV(1)