NOME¶
fgetwc - lê um caractere largo a partir de um fluxo de arquivo
SINOPSE¶
#include <stdio.h>
#include <wchar.h>
wint_t fgetwc (FILE* stream);
wint_t getwc (FILE* stream);
DESCRIÇÃO¶
A função
fgetwc é a equivalente para caracteres largos da
função
fgetc. Ela lê um caractere largo a partir de
stream e a retorna. Se o fim do fluxo é encontrado, ou se
ferror(stream) se torna verdadeiro, ela retorna WEOF. Se ocorre um erro
de conversão para caracteres largos, ela seta
errno para
EILSEQ e retorna WEOF.
A função ou macro
getwc funciona de forma idêntica a
fgetwc. 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.
VALOR DE RETORNO¶
A função
fgetwc retorna o próximo caractere largo que vem
do fluxo, ou WEOF.
ERROS¶
Além dos normais, há
- EILSEQ
- Os dados obtidos a partir do fluxo de entrada não
formam um caractere válido.
ISO/ANSI C, UNIX98
VEJA TAMBÉM¶
fputwc(3),
fgetws(3),
ungetwc(3)
NOTAS¶
O comportamento de
fgetwc depende da categoria LC_CTYPE do 'locale'
corrente.
Na ausência de informações adicionais passadas para a chamada de
'fopen', é razoável esperar que
fgetwc irá ler no
momento uma sequência multibyte a partir do fluxo e então
convertê-la para caracteres largos.
TRADUÇÃO PARA A LÍNGUA PORTUGUESA¶
RUBENS DE JESUS NOGUEIRA <darkseid99@usa.net> (tradução) XXXXXX
XX XXXXX XXXXXXXX <xxxxxxxxxx@xxx.xxx> (revisão)