Provided by:
manpages-es_1.55-8_all 
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)