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

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.