Provided by:
manpages-es_1.55-8_all 
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.