LinuxDoc.Ruiconv_open - определяет параметр для изменения кодировки набора символов
НАЗВАНИЕiconv_open - определяет параметр для изменения кодировки
набора символов
СИНТАКСИС
#include
iconv_t iconv_open(const char* tocode, const char* fromcode);
ОПИСАНИЕ
Функция iconv_open создает параметр, предназначенный для
преобразования кодировки последовательности байтов from-
code в кодировку 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