iconv(1)
NAME
iconv − code set conversion
SYNOPSIS
iconv -f fromcode -t tocode [file ...]
DESCRIPTION
iconv converts the encoding of characters in the input files from the fromcode code set to the tocode code set, and writes the results on standard output. If no input files are given, iconv reads from standard input. If - appears as an input file name, iconv reads standard input at that point. -- can be used to delimit the end of options (see getopt(3C)).
Options
iconv recognizes the following options:
-f fromcode Identify the code set corresponding to option argument fromcode as the code set that the input will be converted “from”.
-t tocode Identify the code set corresponding to option argument tocode as the code set that the input will be converted “to”.
The fromcode and tocode names can be any of the base and alias names listed in the iconv configuration file, /usr/lib/nls/iconv/config.iconv. See iconv(3C) for details and the configuration file for a list of supported code set names.
EXTERNAL INFLUENCES
Environment Variables
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, iconv will behave as if all internationalization variables are set to "C". See environ(5).
LC_ALL If set 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 catalogues for the processing of LC_MESSAGES.
International Code Set Support
Single and multi-byte character code sets are supported.
WARNINGS
If an input character does not have a valid equivalent in the code set selected by the -t option (the "to" code set), 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 code set selected by the -f option (the "from" code set), the command terminates.
EXAMPLES
Convert the contents of file foo from code set Roman8 to ISO 8859/1 and store the results in file bar.
iconv -f roman8 -t iso8859_1 foo > bar
FILES
/usr/lib/nls/iconv/config.iconv iconv configuration file
AUTHOR
iconv was developed by HP.
SEE ALSO
STANDARDS CONFORMANCE
iconv: XPG2, XPG3, XPG4
Hewlett-Packard Company — HP-UX Release 10.20: July 1996