.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
.\"
.\" 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.8" 
.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 <iconv.h>\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 <mpi79470@alu.um.es>
.
.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 .