NOMBRE

       mbrlen - determina el número de bytes en el siguiente carácter multibyte

SINOPSIS

       #include <wchar.h>

       size_t mbrlen (const char *s, size_t n, mbstate_t *ps);

DESCRIPCIÓN

       La  función  mbrlen inspecciona, como mucho, n bytes de la cadena multibyte que comienza en s y determina
       el siguiente carácter multibyte completo. La función actualiza el estado de cambios *ps. Si  el  carácter
       multibyte  no  es  el  carácter  ancho nulo, devuelve el número de bytes que se han consumido de s. Si el
       carácter multibyte es el carácter ancho nulo, restablece el estado de cambios *ps  al  estado  inicial  y
       devuelve 0.

       Si  los  n  bytes  que  comienzan  en  s  no  contienen  un  carácter multibyte completo, mbrlen devuelve
       (size_t)(-2). Esto puede ocurrir incluso si n >= MB_CUR_MAX, si la cadena multibyte  contiene  sequencias
       de cambios redundantes.

       Si  la  cadena  multibyte que comienza en s contiene una secuencia multibyte inválida antes del siguiente
       carácter completo, mbrlen devuelve (size_t)(-1) y asigna a errno el valor  EILSEQ.   En  este  caso,  los
       efectos sobre *ps son indefinidos.

       Si  ps  es  un  puntero  NULL,  en su lugar se usa un estado anónimo privado sólo conocido por la función
       mbrlen.

VALOR DEVUELTO

       La función mbrlen devuelve el número de bytes examinados de la cadena multibyte que comienza en s, si  se
       ha  reconocido un carácter ancho no nulo. Devuelve 0 si se ha reconocido un carácter ancho nulo. Devuelve
       (size_t)(-1) y asigna a errno el valor EILSEQ, si se ha  encontrado  una  secuencia  multibyte  inválida.
       Devuelve  (size_t)(-2) si no ha podido recorrer una carácter multibyte completo, indicando que se debería
       incrementar n.

CONFORME A

       ISO/ANSI C, UNIX98

VÉASE TAMBIÉN

       mbrtowc(3)

OBSERVACIONES

       El comportamiento de mbrlen depende de la categoría LC_CTYPE de la localización actual.

GNU                                               25 julio 1999                                        MBRLEN(3)