ICONV(1) General Commands Manual ICONV(1)NAME
iconv - Convert encoding of given files from one encoding to another
SYNOPSIS
iconv -f encoding -t encoding inputfile
DESCRIPTION
The iconv program converts the encoding of characters in inputfile from one coded character set to another. The result is written to
standard output unless otherwise specified by the --output option.
--from-code, -f encoding
Convert characters from encoding
--to-code, -t encoding
Convert characters to encoding
--list
List known coded character sets
--output, -o file
Specify output file (instead of stdout)
--verbose
Print progress information.
AUTHOR
iconv is written by Ulrich Drepper as part of the GNU C Library.
This man page is written by Joel Klecker <espy@debian.org>, for the Debian GNU/Linux system.
3rd Berkeley Distribution March 2001 ICONV(1)
Check Out this Related Man Page
ICONV(1) Linux Programmer's Manual ICONV(1)NAME
iconv - character set conversion
SYNOPSIS
iconv [OPTION...] [-f encoding] [-t encoding] [inputfile ...]
iconv -l
DESCRIPTION
The iconv program converts text from one encoding to another encoding. More precisely, it converts from the encoding given for the -f
option to the encoding given for the -t option. Either of these encodings defaults to the encoding of the current locale. All the input-
files are read and converted in turn; if no inputfile is given, the standard input is used. The converted text is printed to standard out-
put.
The encodings permitted are system dependent. For the libiconv implementation, they are listed in the iconv_open(3) manual page.
Options controlling the input and output format:
-f encoding, --from-code=encoding
Specifies the encoding of the input.
-t encoding, --to-code=encoding
Specifies the encoding of the output.
Options controlling conversion problems:
-c When this option is given, characters that cannot be converted are silently discarded, instead of leading to a conversion error.
--unicode-subst=formatstring
When this option is given, Unicode characters that cannot be represented in the target encoding are replaced with a placeholder
string that is constructed from the given formatstring, applied to the Unicode code point. The formatstring must be a format string
in the same format as for the printf command or the printf() function, taking either no argument or exactly one unsigned integer
argument.
--byte-subst=formatstring
When this option is given, bytes in the input that are not valid in the source encoding are replaced with a placeholder string that
is constructed from the given formatstring, applied to the byte's value. The formatstring must be a format string in the same format
as for the printf command or the printf() function, taking either no argument or exactly one unsigned integer argument.
--widechar-subst=formatstring
When this option is given, wide characters in the input that are not valid in the source encoding are replaced with a placeholder
string that is constructed from the given formatstring, applied to the byte's value. The formatstring must be a format string in the
same format as for the printf command or the printf() function, taking either no argument or exactly one unsigned integer argument.
Options controlling error output:
-s, --silent
When this option is given, error messages about invalid or unconvertible characters are omitted, but the actual converted text is
unaffected.
The iconv -l or iconv --list command lists the names of the supported encodings, in a system dependent format. For the libiconv implementa-
tion, the names are printed in upper case, separated by whitespace, and alias names of an encoding are listed on the same line as the
encoding itself.
EXAMPLES
iconv -f ISO-8859-1 -t UTF-8
converts input from the old West-European encoding ISO-8859-1 to Unicode.
iconv -f KOI8-R --byte-subst="<0x%x>"
--unicode-subst="<U+%04X>"
converts input from the old Russian encoding KOI8-R to the locale encoding, substituting an angle bracket notation with hexadecimal
numbers for invalid bytes and for valid but unconvertible characters.
iconv --list
lists the supported encodings.
SEE ALSO iconv_open(3)GNU January 22, 2006 ICONV(1)