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

Páginas de manual de Linux 6.03                 15 Diciembre 2022                                     mbsinit(3)