.\" -*- 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 FGETWC 3 "8 agosto 2015" GNU "Manual do Programador do Linux"
.SH NOME
fgetwc, getwc \- lê um caractere largo a partir de um fluxo de arquivo
.SH SINOPSE
.nf
\fB#include <stdio.h>\fP
\fB#include <wchar.h>\fP
.PP
\fBwint_t fgetwc(FILE *\fP\fIfluxo\fP\fB);\fP
\fBwint_t getwc(FILE *\fP\fIfluxo\fP\fB);\fP
.fi
.SH DESCRIÇÃO
A função \fBfgetwc\fP() é a equivalente para caracteres largos da função
\fBfgetc\fP(3). Ela lê um caractere largo a partir de \fIfluxo\fP e o retorna. Se
o fim do fluxo é encontrado, ou se \fIferror(stream)\fP se torna verdadeiro,
ela retorna \fBWEOF\fP. Se ocorre um erro de conversão para caracteres largos,
ela seleciona \fBerrno\fP para \fBEILSEQ\fP e retorna \fBWEOF\fP.
.PP
A função ou macro \fBgetwc\fP() funciona de forma idêntica a \fBfgetwc\fP(). Ela
pode ser implementada como uma macro, e pode avaliar seu argumento mais de
uma vez. Não há razão ainda para usá\-la.
.PP
Para contrapartes não bloqueantes, veja \fBunlocked_stdio\fP(3).
.SH "VALOR DE RETORNO"
A função \fBfgetwc\fP() retorna o próximo caractere largo que vem do fluxo, ou
\fBWEOF\fP. No evento de um erro, \fIerrno\fP é definido para indicar a causa.
.SH ERROS
Além dos normais, há
.TP 
\fBEILSEQ\fP
Os dados obtidos a partir do fluxo de entrada não formam um caractere
válido.
.SH ATRIBUTOS
Para uma explicação dos termos usados nesta seção, consulte
\fBattributes\fP(7).
.TS
allbox;
lbw17 lb lb
l l l.
Interface	Atributo	Valor
T{
\fBfgetwc\fP(),
\fBgetwc\fP()
T}	Thread safety	MT\-Safe
.TE
.SH "DE ACORDO COM"
POSIX.1\-2001, POSIX.1\-2008, C99.
.SH NOTAS
O comportamento de \fBfgetwc\fP() depende da categoria \fBLC_CTYPE\fP da
localização atual.
.PP
Na ausência de informações adicionais passadas para a chamada de
\fBfopen\fP(3), é razoável esperar que \fBfgetwc\fP() irá ler no momento uma
sequência multibyte a partir do fluxo e então convertê\-la para caracteres
largos.
.SH "VEJA TAMBÉM"
\fBfgetws\fP(3), \fBfputwc\fP(3), \fBungetwc\fP(3), \fBunlocked_stdio\fP(3)
.SH COLOFÃO
Esta página faz parte da versão 5.10 do projeto Linux \fIman\-pages\fP. Uma
descrição do projeto, informações sobre relatórios de bugs e a versão mais
recente desta página podem ser encontradas em
\%https://www.kernel.org/doc/man\-pages/.
.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 .