.\" -*- 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
.\"
.\" Modified Tue Oct 16 23:18:40 BST 2001 by John Levon <moz@compsoc.man.ac.uk>
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH FGETWS 3 "6 Marzo 2019" GNU "Manual del Programador de Linux"
.SH NOMBRE
fgetws \- lee una cadena de caracteres anchos de un flujo FILE
.SH SINOPSIS
.nf
\fB#include <wchar.h>\fP
.PP
\fBwchar_t *fgetws(wchar_t *\fP\fIws\fP\fB, int \fP\fIn\fP\fB, FILE *\fP\fIflujo\fP\fB);\fP
.fi
.SH DESCRIPCIÓN
The \fBfgetws\fP()  function is the wide\-character equivalent of the
\fBfgets\fP(3)  function.  It reads a string of at most \fIn\-1\fP wide characters
into the wide\-character array pointed to by \fIws\fP, and adds a terminating
null wide character (L\(aq\e0\(aq).  It stops reading wide characters after
it has encountered and stored a newline wide character.  It also stops when
end of stream is reached.
.PP
El programador debe garantizar que hay espacio suficiente en \fIws\fP para, al
menos, \fIn\fP caracteres anchos.
.PP
Para la versión no\-bloqueante, véase \fBunlocked_stdio\fP(3).
.SH "VALOR DEVUELTO"
La función \fBfgetws\fP() devuelve \fIws\fP en caso de éxito. Si ya se ha
alcanzado el final del flujo o se ha producido un error, devuelve NULL.
.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{
\fBfgetws\fP()
T}	Seguridad del hilo	Multi\-hilo seguro
.TE
.SH "CONFORME A"
POSIX.1\-2001, POSIX.1\-2008, C99.
.SH NOTAS
El comportamiento de \fBfgetws\fP() depende de la categoría \fBLC_CTYPE\fP de la
localización actual.
.PP
En ausencia de información adicional pasada a la llamada \fBfopen\fP(3), es
razonable esperar que \fBfgetws\fP() lea realmente una cadena multibyte del
flujo y que la convierta después en una cadena de caracteres anchos.
.PP
Esta función no es fiable ya que no permite tratar adecuadamente los
caracteres anchos nulos que se puedan presentar en la entrada.
.SH "VÉASE TAMBIÉN"
\fBfgetwc\fP(3), \fBunlocked_stdio\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 .