libiconv (1.17)
Browse
Usage
VersionsICONV_OPEN_INTO(3) Linux Programmer's Manual ICONV_OPEN_INTO(3)
NAME
iconv_open_into - initialize descriptor for character set conversion
SYNOPSIS
#include <iconv.h>
int iconv_open_into (const char* tocode, const char* fromcode,
iconv_allocation_t* resultp);
DESCRIPTION
The iconv_open_into function initializes a conversion descriptor suitable for converting byte sequences from
character encoding fromcode to character encoding tocode. The conversion descriptor is stored in the memory
pointed to by resultp.
The values permitted for fromcode and tocode are the same as for the function iconv_open.
After a successful return from this function, resultp can be be used as an iconv_t object with the iconv func‐
tion.
RETURN VALUE
The iconv_open_into function fills *resultp and returns 0 if it succeeds. In case of error, it sets errno and re‐
turns -1.
ERRORS
The following error can occur, among others:
EINVAL The conversion from fromcode to tocode is not supported by the implementation.
CONFORMING TO
This function is implemented only in GNU libiconv and not in other iconv implementations. It is not backed by a
standard. You can test for its presence through (_LIBICONV_VERSION >= 0x010D).
SEE ALSO
iconv_open(3) iconv(3)
GNU September 21, 2008 ICONV_OPEN_INTO(3)
NAME
iconv_open_into - initialize descriptor for character set conversion
SYNOPSIS
#include <iconv.h>
int iconv_open_into (const char* tocode, const char* fromcode,
iconv_allocation_t* resultp);
DESCRIPTION
The iconv_open_into function initializes a conversion descriptor suitable for converting byte sequences from
character encoding fromcode to character encoding tocode. The conversion descriptor is stored in the memory
pointed to by resultp.
The values permitted for fromcode and tocode are the same as for the function iconv_open.
After a successful return from this function, resultp can be be used as an iconv_t object with the iconv func‐
tion.
RETURN VALUE
The iconv_open_into function fills *resultp and returns 0 if it succeeds. In case of error, it sets errno and re‐
turns -1.
ERRORS
The following error can occur, among others:
EINVAL The conversion from fromcode to tocode is not supported by the implementation.
CONFORMING TO
This function is implemented only in GNU libiconv and not in other iconv implementations. It is not backed by a
standard. You can test for its presence through (_LIBICONV_VERSION >= 0x010D).
SEE ALSO
iconv_open(3) iconv(3)
GNU September 21, 2008 ICONV_OPEN_INTO(3)