Content-type: text/html Man page of iconv

iconv

Section: User Commands (1)
Index Return to Main Contents
 

NAME

iconv - Converts encoded characters to another codeset  

SYNOPSIS

iconv -f from_code -t to_code [file...]


 

STANDARDS

Interfaces documented on this reference page conform to industry standards as follows:

iconv:  XPG4

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.
 

DESCRIPTION

The iconv command converts the encoding of characters in file from one coded character set to another and writes the results to standard output.

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.

[Compaq]  Current industry standards do not specify the name format, implementation, and location of the codeset converters used by this command. On Tru64 UNIX systems, the command searches directories 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


 

EXIT STATUS

Success. An error occurred.
 

ERRORS

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 interpreting byte sequences as characters in, for example, command parameters. Specifies the locale used to find translations, if any, for the command's message catalogs. [Compaq]  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

[Compaq]  Algorithmic converters. [Compaq]  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)

Writing Software for the International Market


 

Index

NAME
SYNOPSIS
STANDARDS
OPTIONS
OPERANDS
DESCRIPTION
EXIT STATUS
ERRORS
EXAMPLES
ENVIRONMENT VARIABLES
FILES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 02:42:54 GMT, October 02, 2010