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 standards 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
       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.

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

       [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 interpreting byte sequences as characters in, for example, command parameters.  Spec-
       ifies the locale used to find translations, if any, for the command'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)

       Writing Software for the International Market

																	  iconv(1)