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

NOMBRE

       mblen - determina el numero de bytes del siguiente caracter multibyte

SINOPSIS

       #include <stdlib.h>

       int mblen (const char *s, size_t n);

DESCRIPCI'ON

       Si s no es un puntero NULL, la funcion mblen inspecciona, como mucho, n
       bytes de la cadena multibyte que comienza en s y  extrae  el  siguiente
       caracter multibyte completo. Usa un estado de cambios anonimo y privado
       solo conocido por la funcion mblen. Si el caracter multibyte no esl  el
       caracter  ancho  nulo, devuelve el numero de bytes que se han consumido
       de s. Si el caracter multibyte es el caracter ancho nulo, devuelve 0.

       Si los n bytes a  partir  de  s  no  contienen  un  caracter  multibyte
       completo,  mblen  devuelve  -1.  Esto  puede  ocurrir  incluso  si n >=
       MB_CUR_MAX, si la  cadena  multibyte  contiene  secuencias  de  cambios
       redundantes.

       Si  la  cadena  multibyte  s  contiene una secuencia multibyte invalida
       antes del siguiente caracter completo, mblen tambien devuelve -1.

       Si s no es un puntero NULL, la funcion  mblen  devuelve  el  estado  de
       cambios,  solo  conocido  por  esta  funcion,  a  su  estado inicial, y
       devuelve un valor distinto de cero si la condificacion posee un  estado
       de cambios no trivial o cero si es una codificacion sin estado.

VALOR DEVUELTO

       La funcion mblen devuelve el numero de bytes recorridos de la secuencia
       multibyte s, si encuentra un caracter ancho no  nulo.   Devuelve  0  si
       encuentra  un  caracter  ancho  nulo.  Devuelve  -1  si  encuentra  una
       secuencia  mulitbyte  invalida  o  si  no  pudo  recorrer  un  caracter
       multibyte completo.

CONFORME A

       ISO/ANSI C, UNIX98

V'EASE TAMBI'EN

       mbrlen(3)

OBSERVACIONES

       El  comportamiento  de  mblen  depende  de  la categoria LC_CTYPE de la
       localizacion actual.

       La  funcion  mbrlen  proporciona  una  interfaz  mejor  con  la   misma
       funcionalidad.