|HP-UX Reference > I
HP-UX 11i Version 3: February 2007
iconv — codeset conversion
iconv [-cs] -f frommap -t tomap [file]...
iconv [-cs] -f fromcode [-t tocode] [file]...
iconv [-cs] -t tocode [-f fromcode] [file]...
The iconv command converts the encoding of characters in the input files from one codeset to another, and writes the results to standard output. If no input files are given, iconv reads from standard input. If - appears as an input file name, the iconv command reads standard input at that point. -- can be used to delimit the end of options (see getopt(3C)).
The iconv command recognizes the following options:
The fromcode and tocode names can be any of the base and alias names listed in the iconv configuration files, /usr/lib/nls/iconv/system.config.iconv or /usr/lib/nls/iconv/config.iconv. See iconv(3C) for details and the configuration files for a list of supported codeset names.
LANG provides a default value for the internationalization variables that are unset or null. If LANG is unset or null, the default value of "C" (see lang(5)) is used. If any of the internationalization variables contains an invalid setting, the iconv command will behave as if all internationalization variables are set to "C". See environ(5).
Setting LC_ALL to a non-empty string value overrides the values of all the other internationalization variables.
LC_CTYPE determines the interpretation of text as single and/or multi-byte characters, the classification of characters as printable, and the characters matched by character class expressions in regular expressions. During translation of the file, this variable is superseded by the use of the fromcode option argument.
LC_MESSAGES determines the locale that should be used to affect the format and contents of diagnostic messages written to standard error and informative messages written to standard output.
NLSPATH determines the location of message catalogs for the processing of LC_MESSAGES.
Convert the contents of file foo from codeset Roman8 to ISO 8859/1 and store the results in file bar.
iconv -f roman8 -t iso8859_1 foo > bar
If an input character does not have a valid equivalent in the codeset selected by the -t option (the "to" codeset), it is mapped to the "galley character", if it has been defined for that conversion (see genxlt(1) and iconv(3C)).
If an input character does not belong to the codeset selected by the -f option (the "from" codeset), the command terminates.