Provided by:
manpages-es_1.55-8_all 
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, y el que
usan las funciones de conversión de carácter ancho a multibyte, tal
como wcsrtombs, 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 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(mbstate_t));
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 devuelve un valor distinto de cero si *ps se encuentra en un
estado inicial o si ps es un puntero nulo. En otro caso, devuelve 0.
CONFORME A
ISO/ANSI C, UNIX98
VÉASE TAMBIÉN
mbsrtowcs(3), wcsrtombs(3)
OBSERVACIONES
El comportamiento de mbsinit depende de la categoría LC_CTYPE de la
localización actual.