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

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.