NAME [Toc] [Back]
iconv - code set conversion
SYNOPSIS [Toc] [Back]
iconv -f fromcode -t tocode [file ...]
DESCRIPTION [Toc] [Back]
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 [Toc] [Back]
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 [Toc] [Back]
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.
Hewlett-Packard Company - 1 - HP-UX 11i Version 2: August 2003
NLSPATH determines the location of message catalogues for the
processing of LC_MESSAGES.
International Code Set Support [Toc] [Back]
Single and multi-byte character code sets are supported.
WARNINGS [Toc] [Back]
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 [Toc] [Back]
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 [Toc] [Back]
/usr/lib/nls/iconv/config.iconv iconv configuration
AUTHOR [Toc] [Back]
iconv was developed by HP.
SEE ALSO [Toc] [Back]
STANDARDS CONFORMANCE [Toc] [Back]
iconv: XPG2, XPG3, XPG4
Hewlett-Packard Company - 2 - HP-UX 11i Version 2: August 2003 [ Back ]