Scroll to navigation

mblen(3) Library Functions Manual 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 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.

2 Mayo 2024 Páginas de Manual de Linux (no publicadas)