ICONV(1) Domain/OS BSD ICONV(1)
NAME
iconv - Converts the encoding of characters from one code set to another
SYNOPSIS
iconv -f from_code -t to_code file | -
The iconv command converts the encoding of characters in file from one
coded character set to another and writes the results to standard output.
DESCRIPTION
The input and output coded character sets are identified by from_code and
to_code. If the file argument is not specified on the 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.
The options are as follows:
-f from_code Specifies the input code.
-t to_code
Specifies the output code.
EXAMPLES
To convert the contents of foo from Roman-8 to Latin-1 and store the
results in bar, enter:
iconv -f roman8 -t iso8859_1 foo > bar
When specifying "iso8859_1" as either the input or output code, iconv
displays the mapping for those characters which do not have a one-to-one
correspondent mapping in the converted character set. To avoid seeing
this mapping information, users should specify "iso88591" instead, or
redirect the results to a output file (for example, redirecting to file
"bar" in the command line above).
WARNINGS
If an input character does not have a valid equivalent in the code set
selected by the -t option, it is mapped to a system defined default
character.
If an input character does not belong to the code set selected by the -f
option, the command terminates.