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)