iconv_open - asigna un descriptor para la conversión del conjunto de
caracteres
Biblioteca Estándar C (
libc,
-lc)
#include <iconv.h>
iconv_t iconv_open(const char *tocode, const char *fromcode);
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.
On success,
iconv_open() returns a freshly allocated conversion
descriptor. On failure, it returns
(iconv_t) -1 and sets
errno to indicate the error.
Pueden ocurrir los siguientes errores, entre otros:
- EINVAL
- La conversión de fromcode a tocode no
está soportada por la implementación.
This function is available since glibc 2.1.
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 |
POSIX.1-2001, POSIX.1-2008, SUSv2.
iconv(1),
iconv(3),
iconv_close(3)
La traducción al español de esta página del manual fue
creada por Miguel Pérez Ibars <
[email protected]>
Esta traducción es documentación libre; lea la
GNU
General Public License Version 3 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
[email protected]