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)