ICONV_OPEN(3)

НАЗВАНИЕ
iconv_open - определяет параметр для изменения кодировки набора символов

СИНТАКСИС
#include <iconv.h>

iconv_t iconv_open(const char* tocode, const char* fromcode);

ОПИСАНИЕ
Функция iconv_open создает параметр, предназначенный для преобразования кодировки последовательности байтов fromcode в кодировку tocode.

Значения, допустимые для кодировок fromcode и tocode, и поддерживаемые комбинации зависят от операционной системы. В случае с библиотекой GNU C разрешенные значения перечисляются командой iconv --list, а также поддерживаются все комбинации перечисленных значений.

Полученный параметр перекодирования может использоваться функцией iconv необходимое количество раз. Он остается неизменным до тех пор, пока не будет уничтожен функцией iconv_close.

Параметр перекодирования указывает на статус процесса перекодировки. После создания параметра функцией iconv_open статус остается начальным. Использование iconv меняет статус процесса (подразумевается, что параметр перекодирования не может использоваться одновременно при выполнении нескольких изменений кодировки). Чтобы вернуть прежний статус, необходимо использовать функцию iconv с параметром inbuf, равным NULL.

ВОЗВРАЩАЕМЫЕ ЗНАЧЕНИЯ
Функция iconv_open возвращает созданный параметр перекодирования. В случае ошибок меняется значение переменной errno и возвращается (iconv_t)(-1).

НАЙДЕННЫЕ ОШИБКИ
Среди прочих могут произойти и такие ошибки:

EINVAL
    (перевод кодировки fromcode в кодировку tocode не поддерживается данной реализацией);

СООТВЕТСТВИЕ СТАНДАРТАМ
UNIX98

СМ. ТАКЖЕ
iconv(3), iconv_close(3), iconv(1)