.\" -*- 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 mbrlen 3 "20 ​​Julio 2023" "Páginas de manual de Linux 6.05.01" 
.SH NOMBRE
mbrlen \- determina el número de bytes en el siguiente carácter multibyte
.SH BIBLIOTECA
Biblioteca Estándar C (\fIlibc\fP, \fI\-lc\fP)
.SH SINOPSIS
.nf
\fB#include <wchar.h>\fP
.PP
\fBsize_t mbrlen(const char \fP\fIs\fP\fB[restrict .\fP\fIn\fP\fB], size_t \fP\fIn\fP\fB,\fP
\fB              mbstate_t *restrict \fP\fIps\fP\fB);\fP
.fi
.SH DESCRIPCIÓN
La función \fBmbrlen\fP() inspecciona, como mucho, \fIn\fP bytes de la cadena
multibyte que comienza en \fIs\fP y determina el siguiente carácter multibyte
completo. La función actualiza el estado de cambios \fI*ps\fP. Si el carácter
multibyte no es el carácter ancho nulo, devuelve el número de bytes que se
han consumido de \fIs\fP. Si el carácter multibyte es el carácter ancho nulo,
restablece el estado de cambios \fI*ps\fP al estado inicial y devuelve 0.
.PP
Si los \fIn\fP bytes que comienzan en \fIs\fP no contienen un carácter multibyte
completo, \fBmbrlen\fP() devuelve \fI(size_t)\ \-2\fP. Esto puede ocurrir incluso
si \fIn\fP >= \fIMB_CUR_MAX\fP, si la cadena multibyte contiene sequencias de
cambios redundantes.
.PP
Si la cadena multibyte que comienza en \fIs\fP contiene una secuencia multibyte
inválida antes del siguiente carácter completo, \fBmbrlen\fP() devuelve
\fI(size_t)\ \-1\fP y asigna a \fIerrno\fP el valor \fBEILSEQ\fP.  En este caso, los
efectos sobre \fI*ps\fP son indefinidos.
.PP
If \fIps\fP is NULL, a static anonymous state known only to the \fBmbrlen\fP()
function is used instead.
.SH "VALOR DEVUELTO"
La función \fBmbrlen\fP() devuelve el número de bytes examinados de la cadena
multibyte que comienza en \fIs\fP, si se ha reconocido un carácter ancho no
nulo. Devuelve 0 si se ha reconocido un carácter ancho nulo. Devuelve
\fI(size_t)\ \-1\fP y asigna a \fIerrno\fP el valor \fBEILSEQ\fP, si se ha encontrado
una secuencia multibyte inválida. Devuelve \fI(size_t)\ \-2\fP si no ha podido
recorrer una carácter multibyte completo, indicando que se debería
incrementar \fIn\fP.
.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
\fBmbrlen\fP()
T}	Seguridad del hilo	MT\-Unsafe race:mbrlen/!ps
.TE
.sp 1
.SH ESTÁNDARES
C11, POSIX.1\-2008.
.SH HISTORIAL
POSIX.1\-2001, C99.
.SH NOTAS
El comportamiento de \fBmbrlen\fP() depende de la categoría \fBLC_CTYPE\fP de la
localización actual.
.SH "VÉASE TAMBIÉN"
\fBmbrtowc\fP(3)
.PP
.SH TRADUCCIÓN
La traducción al español de esta página del manual fue creada por
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 .