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)