.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright, the authors of the Linux man-pages project
.\"
.\" SPDX-License-Identifier: GPL-2.0-or-later
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH fgetws 3 "28 junho 2025" "Linux man\-pages 6.15" 
.SH NOME
fgetws \- lê uma sequência de caracteres largos a partir de um fluxo de
arquivo
.SH BIBLIOTECA
Biblioteca C Padrão (\fIlibc\fP,\ \fI\-lc\fP)
.SH SINOPSE
.nf
\fB#include <wchar.h>\fP
.P
\fBwchar_t *fgetws(\fPint n;
\fB         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 DESCRIÇÃO
A função \fBfgetws\fP() é a equivalente para caracteres largos da função
\fBfgets\fP(3). Ela lê uma sequência de, no máximo, \fIn\-1\fP caracteres largos e
coloca na matriz de caracteres largos apontada por \fIws\fP, e adiciona um
caractere de terminação nulo (L\[aq]\[rs]0\[aq]). Ela para de ler caracteres
largos depois que encontra e armazena um caractere largo de nova linha. Ela
também para quando o fim do fluxo é atingido.
.P
O programador precisa assegurar\-se de que há espaço para pelo menos \fIn\fP
caracteres largos em \fIws\fP.
.P
Para uma contraparte não\-bloqueante, veja \fBunlocked_stdio\fP(3).
.SH "VALOR DE RETORNO"
A função \fBfgetws\fP(), se bem\-sucedida, retorna \fIws\fP. Se o fim do fluxo já
foi encontrado, ou se ocorreu um erro, ela retorna NULL.
.SH ATRIBUTOS
Para uma explicação dos termos usados nesta seção, consulte
\fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
Interface	Atributo	Valor
T{
.na
.nh
\fBfgetws\fP()
T}	Thread safety	MT\-Safe
.TE
.SH PADRÕES
C11, POSIX.1\-2008.
.SH HISTÓRICO
POSIX.1\-2001, C99.
.SH NOTAS
O comportamento de \fBfgetws\fP() depende da categoria \fBLC_CTYPE\fP da
localização atual.
.P
Na ausência de informações adicionais passadas para a chamada \fBfopen\fP(3), é
razoável esperar que \fBfgetws\fP() irá ler, no momento, uma sequência
multibyte a partir do fluxo e então convertê\-la para uma sequência de
caracteres largos.
.P
Esta função não é confiável, porque ela não permite lidar adequadamente com
caracteres largos nulos que possam estar presentes na entrada.
.SH "VEJA TAMBÉM"
\fBfgetwc\fP(3), \fBunlocked_stdio\fP(3)
.PP
.SH TRADUÇÃO
A tradução para português brasileiro desta página man foi criada por
Rubens de Jesus Nogueira <darkseid99@usa.net>,
André Luiz Fassone <lonely_wolf@ig.com.br>
e
Rafael Fontenelle <rafaelff@gnome.org>.
.
.PP
Esta tradução é uma documentação livre; leia a
.UR https://www.gnu.org/licenses/gpl-3.0.html
Licença Pública Geral GNU Versão 3 
.UE
ou posterior para as condições de direitos autorais.
Nenhuma responsabilidade é aceita.
.PP
Se você encontrar algum erro na tradução desta página de manual,
envie um e-mail para
.MT debian-l10n-portuguese@lists.debian.org
a lista de discussão de tradutores
.ME .