oracular (3) iconv_open.3.gz

Provided by: manpages-es-dev_4.23.1-1_all bug

NOMBRE

       iconv_open - asigna un descriptor para la conversión del conjunto de caracteres

BIBLIOTECA

       Biblioteca Estándar C (libc, -lc)

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

       On  success,  iconv_open()   returns  a  freshly allocated conversion descriptor.  On failure, it returns
       (iconv_t) -1 and sets errno to indicate the error.

ERRORES

       Pueden ocurrir los siguientes errores, entre otros:

       EINVAL La conversión de fromcode a tocode no está soportada por la implementación.

ATRIBUTOS

       Para obtener una explicación de los términos usados en esta sección, véase attributes(7).

       ┌─────────────────────────────────────┬────────────────────┬─────────────────────────────────────────────┐
       │InterfazAtributoValor                                       │
       ├─────────────────────────────────────┼────────────────────┼─────────────────────────────────────────────┤
       │iconv_open()                         │ Seguridad del hilo │ Configuración regional de multi-hilo seguro │
       └─────────────────────────────────────┴────────────────────┴─────────────────────────────────────────────┘

ESTÁNDARES

       POSIX.1-2008.

HISTORIAL

       glibc 2.1.  POSIX.1-2001, SUSv2.

VÉASE TAMBIÉN

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

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⟩.