iconv(1)iconv(1)NAMEiconv - Converts encoded characters to another codeset
SYNOPSISiconv-f from_code -t to_code [file...]
STANDARDS
Interfaces documented on this reference page conform to industry stan‐
dards as follows:
iconv: XCU5.0
Refer to the standards(5) reference page for more information about
industry standards and associated tags.
OPTIONS
Specifies the input codeset. Specifies the output codeset.
OPERANDS
Specifies one or more files that contain the data to be converted. If
this operand is omitted, the standard input is used.
DESCRIPTION
The iconv command converts the encoding of characters in file from one
coded character set to another and writes the results to standard out‐
put.
The input and output coded character sets are identified by from_code
and to_code. If the file operand is not specified on the command line,
the iconv command reads the standard input. The result of specifying
invalid characters in the input stream is that the input value is
translated to the substitute character.
[Tru64 UNIX] Current industry standards do not specify the name for‐
mat, implementation, and location of the codeset converters used by
this command. On this operating system, the command searches directo‐
ries of algorithmic and table converters to find one that performs the
requested conversion. The names of codeset converters adhere to the
following format: fromcode_tocode
[SVID3] The command iconv will additionally convert from/to the ISO
8859-1 Latin alphabet No.1, to/from an ISO 646 ASCII variant codeset
for a particular language. The ISO 8859-1 codeset will support the
majority of 8 bit codesets.
EXIT STATUS
Success. An error occurred.
ERRORS
[Tru64 UNIX] You can view the diagnostic messages that may be returned
by the iconv command by entering the following commands: cd
/usr/lib/nls/msg/en_US.ISO8859-1 dspcat iconv.cat
EXAMPLES
The following examples use the iconv command: To convert the contents
of the eucJP_data file from the eucJP to the SJIS codeset and save the
results in the sjis_data file, enter: iconv-f eucJP -t SJIS eucJP_data
> sjis_data To convert the contents of the eucJP_data file from the
eucJP codeset to the UCS-4 codeset and save the results in the
UCS_4_data file, enter: iconv-f eucJP -t UCS-4 eucJP_data > UCS_4_data
ENVIRONMENT VARIABLES
The following environment variables (see i18n_intro(5) and
l10n_intro(5)) affect the execution of the iconv command: Specifies a
default value for the locale category variables that are not set. If
set to a nonempty string value, overrides the values of all other
locale variables, including LANG. Determines the locale for interpret‐
ing byte sequences as characters in, for example, command parameters.
Specifies the locale used to find translations, if any, for the com‐
mand's message catalogs. [Tru64 UNIX] Specifies the search path used
to find locales and the subdirectories that contain codeset converters.
The default is /usr/lib/nls/loc. Determines the location of message
catalogs for the processing of LC_MESSAGES.
FILES
[Tru64 UNIX] Algorithmic converters. [Tru64 UNIX] Table converters.
SEE ALSO
Commands: genxlt(1)
Functions: iconv(3), iconv_close(3), iconv_open(3)
Others: i18n_intro(5), iconv_intro(5), l10n_intro(5), standards(5)iconv(1)
