Provided by: manpages-es_1.55-3_all bug

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)