NOMBRE¶

iconv_open - asigna un descriptor para la conversión del conjunto de caracteres

SINOPSIS¶

#include <iconv.h>

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

DESCRIPCIÓN¶

La función iconv_open asigna un descriptor de conversión adecuado para convertir secuencias de bytes de la codificación de caracteres fromcode a la codificación de caracteres tocode.

Los valores permitidos para fromcode y tocode y las combinaciones soportadas dependen del sistema. Para la biblioteca GNU C, los valores permitidos son listados por la orden iconv --list, y todas las combinaciones de los valores listados están soportadas.

El descriptor de conversión resultante puede ser usado con iconv cualquier número de veces. Permanece válido hasta que se libera con iconv_close.

Un descriptor de conversión contiene un estado de conversión. Después de la creación con iconv_open, el estado se encuentra en el estado inicial. Usar iconv modificará el estado de conversión del descriptor. (Ésto implica que un descriptor de conversión no puede ser utilizado por múltiples hilos simultáneamente.) Para restablecer el estado inicial, use iconv con NULL como argumento inbuf.

VALOR DEVUELTO¶

La función iconv_open devuelve un descriptor de conversión recién asignado. En caso de error, modifica errno con el valor apropiado y devuelve (iconv_t)(-1).

ERRORES¶

Pueden ocurrir los siguientes errores, entre otros:

EINVAL

La conversión de fromcode a tocode no está soportada por la implementación.

CONFORME A¶

UNIX98

VÉASE TAMBIÉN¶

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