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.

CONFORME

       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)

GNU                                            25 de julho de 1999                                     FGETWC(3)