iconv(1) 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 argument is specified on
the command line, iconv reads the standard 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 support 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
7/91 Page 1
iconv(1) iconv(1)
|___________|________|_____________|________|_______________|
| ISO 8859-1| 8859 | ISO 646es | 646es | Spanish |
|___________|________|_____________|________|_______________|
| 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/iconvdata lists the conversions supported.
/usr/lib/iconv/*.t conversion tables.
SEE ALSO
iconv(5) in the Programmer's Reference Manual.
DIAGNOSTICS
iconv returns 0 upon successful completion, 1 otherwise.
Page 2 7/91