.\" -*- coding: UTF-8 -*- .\" Copyright (c) Bruno Haible .\" .\" %%%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 .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH MBSNRTOWCS 3 "9 Junio 2020" GNU "Manual del Programador de Linux" .SH NOMBRE mbsnrtowcs \- convierte una cadena multibyte a una cadena de caracteres anchos .SH SINOPSIS .nf \fB#include \fP .PP \fBsize_t mbsnrtowcs(wchar_t *\fP\fIdest\fP\fB, const char **\fP\fIsrc\fP\fB,\fP \fB size_t \fP\fInms\fP\fB, size_t \fP\fIlen\fP\fB, mbstate_t *\fP\fIps\fP\fB);\fP .fi .PP .RS -4 Requisitos de Macros de Prueba de Características para glibc (véase \fBfeature_test_macros\fP(7)): .RE .PP \fBmbsnrtowcs\fP(): .PD 0 .ad l .RS 4 .TP 4 Desde glibc 2.10: _POSIX_C_SOURCE\ >=\ 200809L .TP Antes de glibc 2.10: _GNU_SOURCE .RE .ad .PD .SH DESCRIPCIÓN La función \fBmbsnrtowcs\fP() es como la función \fBmbsrtowcs\fP(3), salvo que el número de bytes a convertir, comenzando en \fI*src\fP, está limitado a \fInms\fP. .PP Si \fIdest\fP no es un NULL, la función \fBmbsnrtowcs\fP() convierte, como máximo, \fInms\fP bytes de la cadena multibyte \fI*src\fP a una cadena de caracteres anchos que comienza en \fIdest\fP. A lo sumo, se escriben \fIlen\fP caracteres anchos en \fIdest\fP. El estado de cambios \fI*ps\fP se actualiza. La conversión se realiza en realidad llamando repetidamente a \fImbrtowc(Idest, *src, n, ps)\fP, donde \fIn\fP es algún número positivo tal que esta llamada tenga éxito, e incrementa a continuación \fIdest\fP en uno y \fI*src\fP en el número de bytes consumidos. La conversión se puede detener por tres motivos: .IP 1. 3 Se ha encontrado una secuencia multibyte inválida. En este caso se deja \fI*src\fP apuntando a la secuencia multibyte inválida, la función devuelve \fI(size_t)\ \-1\fP y se asigna a \fBerrno\fP el valor \fBEILSEQ\fP. .IP 2. The \fInms\fP limit forces a stop, or \fIlen\fP non\-L\(aq\e0\(aq wide characters have been stored at \fIdest\fP. In this case, \fI*src\fP is left pointing to the next multibyte sequence to be converted, and the number of wide characters written to \fIdest\fP is returned. .IP 3. The multibyte string has been completely converted, including the terminating null wide character (\(aq\e0\(aq) (which has the side effect of bringing back \fI*ps\fP to the initial state). In this case, \fI*src\fP is set to NULL, and the number of wide characters written to \fIdest\fP, excluding the terminating null wide character, is returned. .PP According to POSIX.1, if the input buffer ends with an incomplete character, it is unspecified whether conversion stops at the end of the previous character (if any), or at the end of the input buffer. The glibc implementation adopts the former behavior. .PP Si \fIdest\fP es NULL, se ignora \fIlen\fP, y la conversión procede como antes, salvo que los caracteres anchos obtenidos no se escriben en memoria y que no existe límite de longitud en el destino. .PP En los dos casos anteriores, si \fIps\fP es un puntero NULL, en su lugar se usa un estado anónimo privado, sólo conocido por la función \fBmbsnrtowcs\fP(). .PP Los programadores deben garantizar que hay espacio suficiente en \fIdest\fP para, al menos, \fIlen\fP caracteres anchos. .SH "VALOR DEVUELTO" The \fBmbsnrtowcs\fP() function returns the number of wide characters that make up the converted part of the wide\-character string, not including the terminating null wide character. If an invalid multibyte sequence was encountered, \fI(size_t)\ \-1\fP is returned, and \fIerrno\fP set to \fBEILSEQ\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 lbw29 l l l. Interfaz Atributo Valor T{ \fBmbsnrtowcs\fP() T} Seguridad del hilo MT\-Unsafe race:mbsnrtowcs/!ps .TE .sp 1 .SH "CONFORME A" POSIX.1\-2008. .SH NOTAS El comportamiento de \fBmbsnrtowcs\fP() depende de la categoría LC_CTYPE de la localización actual. .PP Pasar NULL como valor de \fIps\fP no es seguro en un entorno multihilos. .SH "VÉASE TAMBIÉN" \fBiconv\fP(3), \fBmbrtowc\fP(3), \fBmbsinit\fP(3), \fBmbsrtowcs\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 y Marcos Fouces . .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 .