Section (3) iconv_open
iconv_open — allocate descriptor for character set conversion
||const char *tocode,|
|const char *fromcode
allocates a conversion descriptor suitable for converting
byte sequences from character encoding
fromcode to character encoding
The values permitted for
tocode and 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 suffixes:
When the string //TRANSLIT is appended to
tocode, 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
tocode, characters that cannot be represented in the target character set will be silently discarded.
A conversion descriptor contains a conversion state. After
the state is in the initial state. Using iconv(3) modifies the
descriptor_zsingle_quotesz_s conversion state. To bring the state back to the
initial state, use iconv(3) with NULL as
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
tocodeis not supported by the implementation.
For an explanation of the terms used in this section, see attributes(7).
||Thread safety||MT-Safe locale|
This page is part of release 4.16 of the Linux
man-pages project. A
description of the project, information about reporting bugs,
and the latest version of this page, can be found at
Copyright (c) Bruno Haible <haibleclisp.cons.org>
This is free documentation; you can redistribute it and/or
modify it under the terms of the GNU General Public License as
published by the Free Software Foundation; either version 2 of
the License, or (at your option) any later version.
GNU glibc-2 source code and manual
OpenGroup_zsingle_quotesz_s Single UNIX specification
2007-03-31 Bruno Haible, Describe the glibc/libiconv //TRANSLIT
and //IGNORE extensions for _zsingle_quotesz_tocode_zsingle_quotesz_.