Index for Section 1

Alphabetical listing for I

Bottom of page

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
  -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.  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
  0 (Zero)
      Success.

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

   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
      [Tru64 UNIX]  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/*
      [Tru64 UNIX]  Algorithmic converters.

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

Index for Section 1

Alphabetical listing for I

Top of page