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.
UNIX98
VÉASE TAMBIÉN¶
iconv(3),
iconv_close(3),
iconv(1)