Scroll to navigation

MBSINIT(3) Manual del Programador de Linux MBSINIT(3)

NOMBRE

mbsinit - comprueba el estado inicial de cambios

SINOPSIS

#include <wchar.h>
int mbsinit(const mbstate_t *ps);

DESCRIPCIÓN

La conversión de caracteres entre la representación multibyte y la representación de caracteres anchos usa un estado de conversión, del tipo mbstate_t. La conversión de una cadena usa una máquina de estados finitos. Cuando se interrumpe después de terminar la conversión de un determinado número de caracteres, puede necesitar salvar un estado para procesar los restantes caracteres. Tal estado de conversión es necesario por el bien de codificaciones tales como la ISO-2022 y la UTF-7.

El estado inicial es el estado al principio de la conversión de la cadena. Existen dos clases de estado: el que usan las funciones de conversión de multibyte a carácter ancho, tal como mbsrtowcs(3), y el que usan las funciones de conversión de carácter ancho a multibyte, tal como wcsrtombs(3), aunque ambos encajan en un mbstate_t, y ambos poseen la misma representación para un estado inicial.

Para codificaciones de 8 bits, todos los estados son equivalentes al estado inicial. Para codificaciones multibyte como UTF-8, EUC-*, BIG5 o SJIS, las funciones de conversión de carácter ancho a multibyte nunca producen estados no-iniciales, pero las funciones de conversión de multibyte a carácter ancho como mbrtowc(3) sí producen estados no-iniciales cuando son interrumpidas a mitad de un carácter.

Una forma posible de crear un mbstate_t en un estado inicial es asignarle un cero:


mbstate_t state;
memset(&state, 0, sizeof(state));

En Linux, lo siguiente también funciona, aunque podría producir advertencias del compilador:


mbstate_t state = { 0 };

La función mbsinit() comprueba si *ps se corresponde con un estado inicial.

VALOR DEVUELTO

mbsinit() returns nonzero if *ps is an initial state, or if ps is NULL. Otherwise, it returns 0.

ATRIBUTOS

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

Interfaz Atributo Valor
mbsinit() Seguridad del hilo Multi-hilo seguro

CONFORME A

POSIX.1-2001, POSIX.1-2008, C99.

NOTAS

El comportamiento de mbsinit() depende de la categoría LC_CTYPE de la localización actual.

VÉASE TAMBIÉN

mbrlen(3), mbrtowc(3), mbsrtowcs(3), wcrtomb(3), wcsrtombs(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 Juan Piernas <piernas@ditec.um.es> y Miguel Pérez Ibars <mpi79470@alu.um.es>

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 debian-l10n-spanish@lists.debian.org.

1 Noviembre 2020 GNU