Click this button to go to the index for this section.

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:  XPG4

  Refer to the standards(5) reference page for more information about
  industry standards and associated tags.

OPTIONS
  -f from_code
      Specifies the input codeset.

  -t to_code
      Specifies the output codeset.

OPERANDS
  file...
      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.

  [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 requested
  conversion. The names of codeset converters adhere to the following format:

  fromcode_tocode





EXIT STATUS
  0 (Zero)
      Success.

  >0  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:

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

   2.  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:

  LANG
      Specifies a default value for the locale category variables that are
      not set.

  LC_ALL
      If set to a nonempty string value, overrides the values of all other
      locale variables, including LANG.

  LC_CTYPE
      Determines the locale for interpreting byte sequences as characters in,
      for example, command parameters.

  LC_MESSAGES
      Specifies the locale used to find translations, if any, for the
      command's message catalogs.

  LOCPATH
      [DIGITAL]	 Specifies the search path used to find locales and the
      subdirectories that contain codeset converters. The default is
      /usr/lib/nls/loc.

  NLSPATH
      Determines the location of message catalogs for the processing of
      LC_MESSAGES.







FILES
  /usr/lib/nls/loc/iconv/*
      [DIGITAL]	 Algorithmic converters.

  /usr/lib/nls/loc/iconvTable/*
      [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