Provided by: manpages-es-dev_4.13-4_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.

       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
       ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ 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 ⟨⟩.