NAME    [Toc]    [Back]

       iconv - Converts encoded characters to another codeset

SYNOPSIS    [Toc]    [Back]

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

STANDARDS    [Toc]    [Back]

       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    [Toc]    [Back]

       Specifies  the  input codeset.  Specifies the output codeset.

OPERANDS    [Toc]    [Back]

       Specifies one or more files that contain the  data  to  be
       converted.  If this operand is omitted, the standard input
       is used.

DESCRIPTION    [Toc]    [Back]

       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    [Toc]    [Back]

       Success.  An error occurred.

ERRORS    [Toc]    [Back]

       [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    [Toc]    [Back]

       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    [Toc]    [Back]

       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.  [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    [Toc]    [Back]

       [Tru64 UNIX]  Algorithmic converters.  [Tru64 UNIX]  Table
       converters.

SEE ALSO    [Toc]    [Back]

       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)