.\" -*- coding: UTF-8 -*-
.\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
.\"
.\" %%%LICENSE_START(GPLv2+_DOC_ONEPARA)
.\" This is free documentation; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License as
.\" published by the Free Software Foundation; either version 2 of
.\" the License, or (at your option) any later version.
.\" %%%LICENSE_END
.\"
.\" 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 "8 Agosto 2015" GNU "Manual del Programador de Linux"
.SH NOMBRE
mbrlen \- determina el número de bytes en el siguiente carácter multibyte
.SH SINOPSIS
.nf
\fB#include <wchar.h>\fP
.PP
\fBsize_t mbrlen(const char *\fP\fIs\fP\fB, size_t \fP\fIn\fP\fB, mbstate_t *\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;
lb lb lb
l l l.
Interfaz	Atributo	Valor
T{
\fBmbrlen\fP()
T}	Seguridad del hilo	MT\-Unsafe race:mbrlen/!ps
.TE
.SH "CONFORME A"
POSIX.1\-2001, POSIX.1\-2008, 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)
.SH COLOFÓN
Esta página es parte de la versión 5.10 del proyecto Linux
\fIman\-pages\fP. Puede encontrar una descripción del proyecto, información
sobre cómo informar errores y la última versión de esta página en
\%https://www.kernel.org/doc/man\-pages/.
.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 .