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.

GNU                                             20 noviembre 2000                                     MBSINIT(3)