Provided by: manpages-es_1.55-10_all bug

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.