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.
STANDARDS CONFORMANCE
iconv: XPG2, XPG3, XPG4
