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(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.

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

CONFORME A

       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)

COLOFÓN

       Esta página es parte de la versión 5.10 del proyecto Linux man-pages. Puede encontrar  una
       descripción  del  proyecto, información sobre cómo informar errores y la última versión de
       esta página en https://www.kernel.org/doc/man-pages/.

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 ⟨⟩.