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

NOMBRE

       mblen - determina el número de bytes del siguiente carácter multibyte

SINOPSIS

       #include <stdlib.h>

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

DESCRIPCIÓN

       Si s no es un puntero NULL, la función mblen inspecciona, como mucho, n
       bytes de la cadena multibyte que comienza en s y  extrae  el  siguiente
       carácter multibyte completo. Usa un estado de cambios anónimo y privado
       sólo conocido por la función mblen. Si el carácter multibyte no esl  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, devuelve 0.

       Si los n bytes a  partir  de  s  no  contienen  un  carácter  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 inválida
       antes del siguiente carácter completo, mblen también devuelve -1.

       Si s no es un puntero NULL, la función  mblen  devuelve  el  estado  de
       cambios,  sólo  conocido  por  esta  función,  a  su  estado inicial, y
       devuelve un valor distinto de cero si la condificación posee un  estado
       de cambios no trivial o cero si es una codificación sin estado.

VALOR DEVUELTO

       La función mblen devuelve el número de bytes recorridos de la secuencia
       multibyte s, si encuentra un carácter ancho no  nulo.   Devuelve  0  si
       encuentra  un  carácter  ancho  nulo.  Devuelve  -1  si  encuentra  una
       secuencia  mulitbyte  inválida  o  si  no  pudo  recorrer  un  carácter
       multibyte completo.

CONFORME A

       ISO/ANSI C, UNIX98

VÉASE TAMBIÉN

       mbrlen(3)

OBSERVACIONES

       El  comportamiento  de  mblen  depende  de  la categoría LC_CTYPE de la
       localización actual.

       La  función  mbrlen  proporciona  una  interfaz  mejor  con  la   misma
       funcionalidad.