View Source: iconv_open(3) - Waikato Linux Users Group

Edit PageHistory Diff Info LikePages

ICONV_OPEN
!!!ICONV_OPEN
NAME
SYNOPSIS
DESCRIPTION
RETURN VALUE
ERRORS
CONFORMING TO
SEE ALSO
----
!!NAME


iconv_open - allocate descriptor for character set conversion
!!SYNOPSIS


__#include
__ ''tocode''__, const char*__ ''fromcode''__);
__
!!DESCRIPTION


The __iconv_open__ function allocates a conversion
descriptor suitable for converting byte sequences from
character encoding ''fromcode'' to character encoding
''tocode''.


The values permitted for ''fromcode'' and ''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.


The resulting conversion descriptor can be used with
__iconv__ any number of times. It remains valid until
deallocated using __iconv_close__.


A conversion descriptor contains a conversion state. After
creation using __iconv_open__, the state is in the
initial state. Using __iconv__ modifies the descriptor's
conversion state. (This implies that a conversion descriptor
can not be used in multiple threads simultaneously.) To
bring the state back to the initial state, use __iconv__
with NULL as ''inbuf'' argument.
!!RETURN VALUE


The __iconv_open__ function returns a freshly allocated
conversion descriptor. In case of error, it sets
__errno__ and returns (iconv_t)(-1).
!!ERRORS


The following error can occur, among others:


__EINVAL__


The conversion from ''fromcode'' to ''tocode'' is not
supported by the implementation.
!!CONFORMING TO


UNIX98
!!SEE ALSO


iconv(3), iconv_close(3),
iconv(1)
----

3 pages link to iconv_open(3):

This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.

Last edited on Tuesday, June 4, 2002 12:24:24 am by "perry"

Edit PageHistory Diff Info LikePages