UNGETWC(3)

NOME
ungetwc - devolve um caractere largo a uma fluxo FILE

SINÓPSE
#include <wchar.h>

wint_t ungetwc (wint_t wc, FILE *stream);

DESCRIÇÃO
A função ungetwc é a equivalente da função ungetc para caracteres largos. Ela devolve um caractere largo a stream e o retorna.

Se wc é WEOF, ela retorna WEOF. Se wc é um caractere largo inválido, ela seleciona errno para EILSEQ e retorna WEOF.

Se wc é um caractere largo válido, ele é devolvido ao fluxo e se torna, assim, disponível para operações futuras de leitura de caracteres largos. O indicador de posição de arquivo é decrementado de 1 ou mais. O indicador de fim de arquivo (eof) é desligado. O armazenamento de fundo do arquivo (`backing storage') não é afetado.

Nota: wc não precisa ser o último caractere largo lido do fluxo; pode ser qualquer outro caractere largo válido.

Se a implementação suporta múltiplas operações de devolução em seqüência, os caracteres largos lidos serão lids em ordem inversa; entretanto, apenas um nível de devolução é garantido.

VALORES RETORNADOS
A função ungetwc retorna wc se tem sucesso, ou WEOF se falha.

DE ACORDO COM
ISO/ANSI C, UNIX98.

VEJA TAMBÉM
fgetwc(3).

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

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

  Tradução:
Felipe M Pereira <Felipe.Pereira@ic.unicamp.br>

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