ICONV_OPEN(3)

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