NOMBRE

       mbsinit - comprueba el estado inicial de cambios

BIBLIOTECA

       Biblioteca Estándar C (libc, -lc)

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.

       For 8-bit encodings, all states are  equivalent  to  the  initial  state.   For  multibyte
       encodings  like  UTF-8,  EUC-*,  BIG5, or SJIS, the wide character to multibyte conversion
       functions never produce non-initial states, but the multibyte to wide-character conversion
       functions like mbrtowc(3)  do produce non-initial states when interrupted in the middle of
       a character.

       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 │
       └────────────────────────────────────────────────┴────────────────────┴───────────────────┘

ESTÁNDARES

       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)

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
       ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ 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⟩.