ICONV(1)            RISC/os Reference Manual             ICONV(1)



NAME
     iconv - code set conversion utility

SYNOPSIS
     iconv -f fromcode -t tocode [file]

DESCRIPTION
     iconv converts the characters or sequences of characters in
     file from one code set to another and writes the results to
     standard output. Should no conversion exist for a particular
     character then it is converted to the underscore '_' in the
     target codeset.

     The required arguments fromcode and tocode identify the
     input and output code sets, respectively.  If no file argu-
     ment is specified on the command line, iconv reads the stan-
     dard input.

     iconv will always convert to or from the ISO 8859-1 Latin
     alphabet No.1, from or to an ISO 646 ASCII variant codeset
     for a particular language.  The ISO 8859-1 codeset will sup-
     port the majority of 8 bit codesets. The conversions
     attempted by iconv accommodate the most commonly used
     languages.

     The following table lists the supported conversions:

     ____________________________________________________________
    |_______________Code_Set_Conversions_Supported______________|
    |    Code   |  Symbol|  Target Code|  Symbol|     comment   |
    |___________|________|_____________|________|_______________|
    |_ISO_646___|__646___|__ISO_8859-1_|__8859__|__US_ASCII_____|
    | ISO 646de |  646de |  ISO 8859-1 |  8859  |  German       |
    |___________|________|_____________|________|_______________|
    |_ISO_646da_|__646da_|__ISO_8859-1_|__8859__|__Danish_______|
    | ISO 646en |  646en |  ISO 8859-1 |  8859  |  English ASCII|
    |___________|________|_____________|________|_______________|
    |_ISO_646es_|__646es_|__ISO_8859-1_|__8859__|__Spanish______|
    | ISO 646fr |  646fr |  ISO 8859-1 |  8859  |  French       |
    |___________|________|_____________|________|_______________|
    |_ISO_646it_|__646it_|__ISO_8859-1_|__8859__|__Italian______|
    | ISO 646sv |  646sv |  ISO 8859-1 |  8859  |  Swedish      |
    |___________|________|_____________|________|_______________|
    |_ISO_8859-1|__8859__|__ISO_646____|__646___|__7_bit_ASCII__|
    | ISO 8859-1|  8859  |  ISO 646de  |  646de |  German       |
    |___________|________|_____________|________|_______________|
    |_ISO_8859-1|__8859__|__ISO_646da__|__646da_|__Danish_______|
    | ISO 8859-1|  8859  |  ISO 646en  |  646en |  English ASCII|
    |___________|________|_____________|________|_______________|
    |_ISO_8859-1|__8859__|__ISO_646es__|__646es_|__Spanish______|
    |___________|________|_____________|________|_______________|




                        Printed 11/19/92                   Page 1

ICONV(1)            RISC/os Reference Manual             ICONV(1)



    | ISO 8859-1   8859     ISO 646fr     646fr    French       |
    |___________|________|_____________|________|_______________|
    |_ISO_8859-1|__8859__|__ISO_646it__|__646it_|__Italian______|
    | ISO 8859-1|  8859  |  ISO 646sv  |  646sv |  Swedish      |
    |___________|________|_____________|________|_______________|

     The conversions are performed according to the tables found
     on the iconv(5) manual page.


EXAMPLES
     The following converts the contents of file mail1 from code
     set 8859 to 646fr and stores the results in file mail.local.

                iconv -f 8859 -t 646fr mail1 > mail.local

FILES
     /usr/lib/iconv/iconv_data                  lists the conversions supported.
     /usr/lib/iconv/*.t                         conversion tables.

SEE ALSO
     iconv(5) in the System Administrator's Reference Manual.

DIAGNOSTICS
     iconv returns 0 upon successful completion, 1 otherwise.






























 Page 2                 Printed 11/19/92