Provided by:
manpages-es_1.55-10_all 
NOMBRE
mbrlen - determina el numero de bytes en el siguiente caracter
multibyte
SINOPSIS
#include <wchar.h>
size_t mbrlen (const char *s, size_t n, mbstate_t *ps);
DESCRIPCI'ON
La funcion mbrlen inspecciona, como mucho, n bytes de la cadena
multibyte que comienza en s y determina el siguiente caracter multibyte
completo. La funcion actualiza el estado de cambios *ps. Si el caracter
multibyte no es el caracter ancho nulo, devuelve el numero de bytes que
se han consumido de s. Si el caracter multibyte es el caracter 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 caracter 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 invalida antes del siguiente caracter 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 anonimo privado
solo conocido por la funcion mbrlen.
VALOR DEVUELTO
La funcion mbrlen devuelve el numero de bytes examinados de la cadena
multibyte que comienza en s, si se ha reconocido un caracter ancho no
nulo. Devuelve 0 si se ha reconocido un caracter ancho nulo. Devuelve
(size_t)(-1) y asigna a errno el valor EILSEQ, si se ha encontrado una
secuencia multibyte invalida. Devuelve (size_t)(-2) si no ha podido
recorrer una caracter multibyte completo, indicando que se deberia
incrementar n.
CONFORME A
ISO/ANSI C, UNIX98
V'EASE TAMBI'EN
mbrtowc(3)
OBSERVACIONES
El comportamiento de mbrlen depende de la categoria LC_CTYPE de la
localizacion actual.