.\" -*- coding: UTF-8 -*- '\" t .\" Copyright (c) Bruno Haible .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" .\" References consulted: .\" GNU glibc-2 source code and manual .\" OpenGroup's Single UNIX specification .\" http://www.UNIX-systems.org/online.html .\" .\" 2007-03-31 Bruno Haible, Describe the glibc/libiconv //TRANSLIT .\" and //IGNORE extensions for 'tocode'. .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH iconv_open 3 "2 Mayo 2024" "Páginas de Manual de Linux 6.9.1" .SH NOMBRE iconv_open \- asigna un descriptor para la conversión del conjunto de caracteres .SH BIBLIOTECA Biblioteca Estándar C (\fIlibc\fP, \fI\-lc\fP) .SH SINOPSIS .nf \fB#include \fP .P \fBiconv_t iconv_open(const char *\fP\fItocode\fP\fB, const char *\fP\fIfromcode\fP\fB);\fP .fi .SH DESCRIPCIÓN La función \fBiconv_open\fP() asigna un descriptor de conversión adecuado para convertir secuencias de bytes de la codificación de caracteres \fIfromcode\fP a la codificación de caracteres \fItocode\fP. .P The values permitted for \fIfromcode\fP and \fItocode\fP and the supported combinations are system\-dependent. For the GNU C library, the permitted values are listed by the \fIiconv \-\-list\fP 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: .TP //TRANSLIT When the string "//TRANSLIT" is appended to \fItocode\fP, 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. .TP //IGNORE When the string "//IGNORE" is appended to \fItocode\fP, characters that cannot be represented in the target character set will be silently discarded. .P El descriptor de conversión resultante puede ser usado con \fBiconv\fP(3) cualquier número de veces. Permanece válido hasta que se libera con \fBiconv_close\fP(3). .P A conversion descriptor contains a conversion state. After creation using \fBiconv_open\fP(), the state is in the initial state. Using \fBiconv\fP(3) modifies the descriptor's conversion state. To bring the state back to the initial state, use \fBiconv\fP(3) with NULL as \fIinbuf\fP argument. .SH "VALOR DEVUELTO" On success, \fBiconv_open\fP() returns a freshly allocated conversion descriptor. On failure, it returns \fI(iconv_t)\ \-1\fP and sets \fIerrno\fP to indicate the error. .SH ERRORES Pueden ocurrir los siguientes errores, entre otros: .TP \fBEINVAL\fP La conversión de \fIfromcode\fP a \fItocode\fP no está soportada por la implementación. .SH ATRIBUTOS Para obtener una explicación de los términos usados en esta sección, véase \fBattributes\fP(7). .TS allbox; lbx lb lb l l l. Interfaz Atributo Valor T{ .na .nh \fBiconv_open\fP() T} Seguridad del hilo Configuración regional de multi\-hilo seguro .TE .SH ESTÁNDARES POSIX.1\-2008. .SH HISTORIAL glibc 2.1. POSIX.1\-2001, SUSv2. .SH "VÉASE TAMBIÉN" \fBiconv\fP(1), \fBiconv\fP(3), \fBiconv_close\fP(3) .PP .SH TRADUCCIÓN La traducción al español de esta página del manual fue creada por Miguel Pérez Ibars . .PP Esta traducción es documentación libre; lea la .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License Version 3 .UE o posterior con respecto a las condiciones de copyright. No existe NINGUNA RESPONSABILIDAD. .PP Si encuentra algún error en la traducción de esta página del manual, envíe un correo electrónico a .MT debian-l10n-spanish@lists.debian.org .ME .