NOMBRE¶

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

BIBLIOTECA¶

Biblioteca Estándar C (libc, -lc)

SINOPSIS¶

#include <stdlib.h>

int mblen(const char s[.n], size_t n);

DESCRIPCIÓN¶

If s is not NULL, the mblen() function inspects at most n bytes of the multibyte string starting at s and extracts the next complete multibyte character. It uses a static anonymous shift state known only to the mblen() function. If the multibyte character is not the null wide character, it returns the number of bytes that were consumed from s. If the multibyte character is the null wide character, it returns 0.

If the n bytes starting at s do not contain a complete multibyte character, mblen() returns -1. This can happen even if n is greater than or equal to MB_CUR_MAX, if the multibyte string contains redundant shift sequences.

Si la cadena multibyte s contiene una secuencia multibyte inválida antes del siguiente carácter completo, mblen() también devuelve -1.

If s is NULL, the mblen() function resets the shift state, known to only this function, to the initial state, and returns nonzero if the encoding has nontrivial shift state, or zero if the encoding is stateless.

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.

ATRIBUTOS¶

Para obtener una explicación de los términos usados en esta sección, véase attributes(7).

ESTÁNDARES¶

POSIX.1-2001, POSIX.1-2008, C99.

NOTAS¶

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

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

VÉASE TAMBIÉN¶

mbrlen(3)

TRADUCCIÓN¶

La traducción al español de esta página del manual fue creada por Gerardo Aburruzaga García <gerardo.aburruzaga@uca.es> y Juan Piernas <piernas@ditec.um.es>

Esta traducción es documentación libre; lea la GNU General Public License Version 3 o posterior con respecto a las condiciones de copyright. No existe NINGUNA RESPONSABILIDAD.

Si encuentra algún error en la traducción de esta página del manual, envíe un correo electrónico a debian-l10n-spanish@lists.debian.org.