iconv_open - allocate descriptor for character set conversion
The iconv_open() function allocates a conversion
descriptor suitable for converting byte sequences from character
fromcode to character encoding
The values permitted for
the supported combinations are system-dependent. For the GNU C library,
the permitted values are listed by the
iconv --list command,
and all combinations of the listed values are supported. Furthermore the
GNU C library and the GNU libiconv library support the following two
When the string "//TRANSLIT" is appended to
transliteration is activated. This means that when a character cannot be
represented in the target character set, it can be approximated through
one or several similarly looking characters.
When the string "//IGNORE" is appended to
that cannot be represented in the target character set will be silently
A conversion descriptor contains a conversion state. After creation
using iconv_open(), the state is in the initial state.
Using iconv(3) modifies the descriptor's conversion
state. To bring the state back to the initial state, use
iconv(3) with NULL as
The iconv_open() function returns a freshly
allocated conversion descriptor. In case of error, it sets
errno and returns
The following error can occur, among others:
The conversion from
tocode is not
supported by the implementation.
This function is available in glibc since version 2.1.
POSIX.1-2001, POSIX.1-2008, SUSv2.
This page is part of release 5.10 of the Linux
project. A description of the project, information about reporting bugs,
and the latest version of this page, can be found at