HP-UX Reference (11i v1 05/09) - 1 User Commands A-M (vol 1)

i
iconv(1) 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 con-
tains 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 vari-
ables.
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 expres-
sions. 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.
HP-UX 11i Version 1: September 2005 − 1 − Hewlett-Packard Company Section 1−−361