unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



iconv(1)							     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 indus-
  try 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 com-
  mand.	 On this operating system, the command searches	directories of algo-
  rithmic 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