.\" -*- 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
.\"
.\" 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 "20 ​​Julio 2023" "Páginas de manual de Linux 6.05.01" 
.SH NOMBRE
fgetws \- lee una cadena de caracteres anchos de un flujo FILE
.SH BIBLIOTECA
Biblioteca Estándar C (\fIlibc\fP, \fI\-lc\fP)
.SH SINOPSIS
.nf
\fB#include <wchar.h>\fP
.PP
\fBwchar_t *fgetws(wchar_t \fP\fIws\fP\fB[restrict .\fP\fIn\fP\fB], int \fP\fIn\fP\fB, FILE *restrict \fP\fIstream\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;
lbx lb lb
l l l.
Interfaz	Atributo	Valor
T{
.na
.nh
\fBfgetws\fP()
T}	Seguridad del hilo	Multi\-hilo seguro
.TE
.sp 1
.SH ESTÁNDARES
C11, POSIX.1\-2008.
.SH HISTORIAL
POSIX.1\-2001, 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)
.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 .