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.

       The  values  permitted  for fromcode and tocode and the supported combinations are system-dependent.  For
       the GNU C library, the permitted values are listed by the iconv --list command, and all  combinations  of
       the  listed values are supported.  Furthermore the GNU C library and the GNU libiconv library support the
       following two suffixes:

       //TRANSLIT
              When the string "//TRANSLIT" is appended to tocode, transliteration is activated.  This means that
              when a character cannot be represented in the target character set, it can be approximated through
              one or several similarly looking characters.

       //IGNORE
              When the string "//IGNORE" is appended to tocode, characters that cannot  be  represented  in  the
              target character set will be silently discarded.

       El  descriptor de conversión resultante puede ser usado con iconv(3) cualquier número de veces. Permanece
       válido hasta que se libera con iconv_close(3).

       A conversion descriptor contains a conversion state.  After creation using iconv_open(), the state is  in
       the  initial  state.  Using iconv(3) modifies the descriptor's conversion state.  To bring the state back
       to the initial state, use iconv(3)  with NULL as inbuf argument.

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.

VERSIONES

       This function is available in glibc since version 2.1.

ATRIBUTOS

       Para obtener una explicación de los términos usados en esta sección, véase attributes(7).
       ┌──────────────┬────────────────────┬─────────────────────────────────────────────┐
       │ Interfaz     │ Atributo           │ Valor                                       │
       ├──────────────┼────────────────────┼─────────────────────────────────────────────┤
       │ iconv_open() │ Seguridad del hilo │ Configuración regional de multi-hilo seguro │
       └──────────────┴────────────────────┴─────────────────────────────────────────────┘

CONFORME A

       POSIX.1-2001, POSIX.1-2008, SUSv2.

VÉASE TAMBIÉN

       iconv(1), iconv(3), iconv_close(3)

COLOFÓN

       Esta página es parte de la versión 5.10 del proyecto Linux man-pages. Puede encontrar una descripción del
       proyecto,   información   sobre   cómo   informar   errores  y  la  última  versión  de  esta  página  en
       https://www.kernel.org/doc/man-pages/.

TRADUCCIÓN

       La traducción al español de esta página del manual fue creada por Miguel Pérez Ibars <mpi79470@alu.um.es>

       Esta traducción es documentación libre;  lea  la  GNU General Public License Version 3  o  posterior  con
       respecto a las condiciones de copyright.  No existe NINGUNA RESPONSABILIDAD.

       Si  encuentra  algún  error  en  la  traducción  de esta página del manual, envíe un correo electrónico a
       debian-l10n-spanish@lists.debian.org.

GNU                                            15 Septiembre 2017                                  ICONV_OPEN(3)