mblen - determina el número de bytes del siguiente carácter
multibyte
Biblioteca Estándar C (
libc,
-lc)
#include <stdlib.h>
int mblen(const char s[.n], size_t 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.
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.
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 |
POSIX.1-2001, POSIX.1-2008, C99.
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.
mbrlen(3)
La traducción al español de esta página del manual fue
creada por Gerardo Aburruzaga García <
[email protected]>
y Juan Piernas <
[email protected]>
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
[email protected]