.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
.\"
.\" SPDX-License-Identifier: GPL-2.0-or-later
.\"
.\" References consulted:
.\"   GNU glibc-2 source code and manual
.\"   Dinkumware C library reference http://www.dinkumware.com/
.\"   OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
.\"   ISO/IEC 9899:1999
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH mblen 3 "20 ​​Julio 2023" "Páginas de manual de Linux 6.05.01" 
.SH NOMBRE
mblen \- determina el número de bytes del siguiente carácter multibyte
.SH BIBLIOTECA
Biblioteca Estándar C (\fIlibc\fP, \fI\-lc\fP)
.SH SINOPSIS
.nf
\fB#include <stdlib.h>\fP
.PP
\fBint mblen(const char \fP\fIs\fP\fB[.\fP\fIn\fP\fB], size_t \fP\fIn\fP\fB);\fP
.fi
.SH DESCRIPCIÓN
If \fIs\fP is not NULL, the \fBmblen\fP()  function inspects at most \fIn\fP bytes of
the multibyte string starting at \fIs\fP and extracts the next complete
multibyte character.  It uses a static anonymous shift state known only to
the \fBmblen\fP()  function.  If the multibyte character is not the null wide
character, it returns the number of bytes that were consumed from \fIs\fP.  If
the multibyte character is the null wide character, it returns 0.
.PP
If the \fIn\fP bytes starting at \fIs\fP do not contain a complete multibyte
character, \fBmblen\fP()  returns \-1.  This can happen even if \fIn\fP is greater
than or equal to \fIMB_CUR_MAX\fP, if the multibyte string contains redundant
shift sequences.
.PP
Si la cadena multibyte \fIs\fP contiene una secuencia multibyte inválida antes
del siguiente carácter completo, \fBmblen\fP() también devuelve \-1.
.PP
.\" The Dinkumware doc and the Single UNIX specification say this, but
.\" glibc doesn't implement this.
If \fIs\fP is NULL, the \fBmblen\fP()  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.
.SH "VALOR DEVUELTO"
La función \fBmblen\fP() devuelve el número de bytes recorridos de la secuencia
multibyte \fIs\fP, 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.
.SH ATRIBUTOS
Para obtener una explicación de los términos usados en esta sección, véase
\fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
Interfaz	Atributo	Valor
T{
.na
.nh
\fBmblen\fP()
T}	Seguridad del hilo	MT \- Carrera insegura
.TE
.sp 1
.SH VERSIONES
La función \fBmbrlen\fP(3) proporciona una interfaz mejor con la misma
funcionalidad.
.SH ESTÁNDARES
C11, POSIX.1\-2008.
.SH HISTORIAL
POSIX.1\-2001, C99.
.SH NOTAS
El comportamiento de \fBmblen\fP() depende de la categoría \fBLC_CTYPE\fP de la
localización actual.
.SH "VÉASE TAMBIÉN"
\fBmbrlen\fP(3)
.PP
.SH 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>
.
.PP
Esta traducción es documentación libre; lea la
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License Version 3
.UE
o posterior con respecto a las condiciones de copyright.
No existe NINGUNA RESPONSABILIDAD.
.PP
Si encuentra algún error en la traducción de esta página del manual, envíe un
correo electrónico a
.MT debian-l10n-spanish@lists.debian.org
.ME .