iconv_open

ICONV_OPEN(3)           Manual del Programador de Linux          ICONV_OPEN(3)



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)