ICONVCTL(3) | Library Functions Manual | ICONVCTL(3) |
iconvctl
—
controlling and diagnostical facility for
iconv(3)
Standard C Library (libc, -lc)
#include
<iconv.h>
int
iconvctl
(iconv_t
cd, int request,
void *argument);
The
iconvctl
()
function can retrieve or set specific conversion setting from the
cd conversion descriptor. The
request parameter specifies the operation to
accomplish and argument is an operation-specific
argument.
The possible operations are the following:
iconvctl
via argument by its
address.EILSEQ
or not. The answer is stored in
argument, which is of int *.
It will be set to 1 if this feature is enabled or set to 0 otherwise.EILSEQ
or not. If argument,
which is of int * is set to 1 it will be enabled,
and if argument is set to 0 it will be
disabled.iconvctl
via argument by its
address. Setting argument to
NULL
will clear the fallback functions.Upon successful completion iconvctl
(),
returns 0. Otherwise, -1 is returned and errno is set to specify the kind of
error.
The iconvctl
() function may cause an error
in the following cases:
The iconvctl
facility is a non-standard
extension, which appeared in the GNU implementation and was adopted in
FreeBSD 9.0 for compatibility's sake.
This manual page was written by Gabor Kovesdan <gabor@FreeBSD.org>.
Transliteration is enabled in this implementation by default, so it is impossible by design to turn it off. Accordingly, trying to turn it off will always fail and -1 will be returned. Getting the transliteration state will always succeed and indicate that it is turned on, though.
November 25, 2009 | Mac OS X 12 |