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)

GNU                                             27 noviembre 1999                                  ICONV_OPEN(3)