iconv(1)

iconv(1)

NAME

iconv - code set conversion

SYNOPSIS

iconv -ffromcode -ttocode [ ®le ... ]

DESCRIPTION

iconv converts the encoding of characters in the input ®les from the fromcode code set to the tocode code set, and writes the results on standard output. If no input ®les are given, iconv reads from standard input. If - appears as an input ®le 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:

-ffromcode Identify the code set corresponding to option argument fromcode as the code set that the input will be converted ``from''.

-ttocode 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 con®guration ®le, /usr/lib/nls/iconv/config.iconv. See iconv(3C) for details and the con®guration ®le 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 vari- ables.

LC_CTYPE determines the interpretation of text as single and/or multi-byte characters, the classi®cation of characters as printable, and the characters matched by character class expressions in regular expres- sions. During translation of the ®le, 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 -toption (the "to" code set), it is mapped to the "galley character", if it has been de®ned for that conversion. (see genxlt(1) and iconv(3C) ).

If an input character does not belong to the code set selected by the -foption (the "from" code set), the command terminates.

EXAMPLES

Convert the contents of ®le foo from code set Roman8 to ISO 8859/1 and store the results in ®le bar.

iconv -f roman8 -t iso8859_1 foo > bar

FILES

iconv con®guration ®le

/usr/lib/nls/iconv/config.iconv

AUTHOR

 

iconv was developed by HP.

 

i

HP-UX Release 11i: December 2000

− 1 −

Section 1−347