.\" -*- coding: UTF-8 -*- '\" t .\" Copyright (c) Bruno Haible .\" .\" 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 .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH fgetws 3 "23 julho 2024" "Linux man\-pages 6.12" .SH NOME fgetws \- lê uma sequência de caracteres largos a partir de um fluxo de arquivo .SH BIBLIOTECA Standard C library (\fIlibc\fP,\ \fI\-lc\fP) .SH SINOPSE .nf \fB#include \fP .P \fBwchar_t *fgetws(wchar_t \fP\fIws\fP\fB[restrict .\fP\fIn\fP\fB], int \fP\fIn\fP\fB, ARQUIVO *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 , André Luiz Fassone e Rafael Fontenelle . . .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 .