Provided by:
manpages-es_1.55-10_all 
NOMBRE
mbsinit - comprueba el estado inicial de cambios
SINOPSIS
#include <wchar.h>
int mbsinit (const mbstate_t *ps);
DESCRIPCI'ON
La conversion de caracteres entre la representacion multibyte y la
representacion de caracteres anchos usa un estado de conversion, del
tipo mbstate_t. La conversion de una cadena usa una maquina de estados
finitos. Cuando se interrumpe despues de terminar la conversion de un
determinado numero de caracteres, puede necesitar salvar un estado para
procesar los restantes caracteres. Tal estado de conversion 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 conversion de la
cadena. Existen dos clases de estado: el que usan las funciones de
conversion de multibyte a caracter ancho, tal como mbsrtowcs, y el que
usan las funciones de conversion de caracter ancho a multibyte, tal
como wcsrtombs, aunque ambos encajan en un mbstate_t, y ambos poseen la
misma representacion 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 conversion de caracter ancho a multibyte nunca
producen estados no-iniciales, pero las funciones de conversion de
multibyte a caracter ancho como mbrtowc si producen estados no-
iniciales cuando son interrumpidas a mitad de un caracter.
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 tambien funciona, aunque podria producir
advertencias del compilador:
mbstate_t state = { 0 };
La funcion 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'EASE TAMBI'EN
mbsrtowcs(3), wcsrtombs(3)
OBSERVACIONES
El comportamiento de mbsinit depende de la categoria LC_CTYPE de la
localizacion actual.