*** UNIX MANUAL PAGE BROWSER ***

iconv(1) General Commands Manual iconv(1) 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 stan- dards as follows: iconv: XPG4 Refer to the standards(5) reference page for more information about in- dustry 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 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. [DIGITAL] Current industry standards do not specify the name format, implementation, and location of the codeset converters used by this command. On DIGITAL UNIX systems, the command searches directories of algorithmic and table converters to find one that performs the re- quested conversion. The names of codeset converters adhere to the fol- lowing 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 eu- cJP 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_in- tro(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 vari- ables, including LANG. Determines the locale for interpreting byte se- quences as characters in, for example, command parameters. Specifies the locale used to find translations, if any, for the command's message catalogs. [DIGITAL] 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 [DIGITAL] Algorithmic converters. [DIGITAL] 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 iconv(1)