FGETWC(3)

NOME
fgetwc - lê um caractere largo a partir de um fluxo de arquivo

SINÓPSE
#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 o 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 seleciona 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.

VALORES RETORNADOS
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.

DE ACORDO COM
ISO/ANSI C, UNIX98.

VEJA TAMBÉM
fputwc(3), fgetws(3), ungetwc(3).

NOTAS
O comportamento de fgetwc depende da categoria LC_CTYPE da localização atual.

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.

TRADUZIDO POR LDP-BR em 21/08/2000.

  Tradução:
Rubens de Jesus Nogueira <darkseid99@usa.net>

  Revisão.:
André Luiz Fassone <lonely_wolf@ig.com.br>