Provided by: manpages-pt-dev_20040726-4_all bug

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)