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.

GNU                                               25 julio 1999                                         MBLEN(3)