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.
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.