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

NOME

       fgetwc - le 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,C~AO

       A funcao fgetwc e a equivalente para caracteres largos da funcao fgetc.
       Ela le um caractere largo a partir de stream e a retorna. Se o  fim  do
       fluxo  e  encontrado,  ou  se  ferror(stream)  se torna verdadeiro, ela
       retorna WEOF. Se ocorre um erro de conversao  para  caracteres  largos,
       ela seta errno para EILSEQ e retorna WEOF.

       A  funcao  ou macro getwc funciona de forma identica a fgetwc. Ela pode
       ser implementada como uma macro, e pode avaliar seu argumento  mais  de
       uma vez. Nao ha razao ainda para usa-la.

VALOR DE RETORNO

       A  funcao fgetwc retorna o proximo caractere largo que vem do fluxo, ou
       WEOF.

ERROS

       Alem dos normais, ha

       EILSEQ Os dados obtidos a partir do fluxo  de  entrada  nao  formam  um
              caractere valido.

CONFORME

       ISO/ANSI C, UNIX98

VEJA TAMB'EM

       fputwc(3), fgetws(3), ungetwc(3)

NOTAS

       O  comportamento  de  fgetwc  depende da categoria LC_CTYPE do 'locale'
       corrente.

       Na ausencia de  informacoes  adicionais  passadas  para  a  chamada  de
       'fopen', e razoavel esperar que fgetwc ira ler no momento uma sequencia
       multibyte a partir do fluxo e entao converte-la para caracteres largos.

TRADU,C~AO PARA A L'INGUA PORTUGUESA

       RUBENS DE JESUS  NOGUEIRA  <darkseid99@usa.net>  (traducao)  XXXXXX  XX
       XXXXX XXXXXXXX <xxxxxxxxxx@xxx.xxx> (revisao)