mblen(3)

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).
Interfaz | Atributo | Valor
mblen() | Seguridad del hilo | MT - Carrera insegura

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

ESTÁNDARES
C11, POSIX.1-2008.

HISTORIAL
POSIX.1-2001, C99.

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

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 (https://www.gnu.org/licenses/gpl-3.0.html) 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.