Character Manipulation Function

int ungetc(int c, FILE *stream);

wint_t ungetwc(wint_t c, FILE *stream);

_TINT _ungettc(_TINT c, FILE *stream);

Internationalization (I18n) Function Overview

The ungetc function pushes the character c back onto stream and clears the end-of-file indicator. It returns c if successful. If c is EOF, or there is an error, ungetc does nothing and just returns EOF. This lets you call ungetc with the return value of getc without needing to check for an error from getc.

ungetwc is the wide character equivalent of ungetc; its parameter and return are wide character values. If unsuccessful, WEOF is returned.

_ungettc is the Windows-only Generic version of the function; with the _MBCS or _UNICODE compiler flags determining its mapping to either ungetc or ungetwc.

I18n Issues

Use the appropriate version of the function as required for internationalization support.

See Character I/O for a discussion on non-ASCII character input/output in an internationalized application.

Recommended Replacements*

ANSI UTF-8	ungetc
ANSI UTF-16	ungetwc
Microsoft Windows MBCS	ungetc
Microsoft Windows Unicode	ungetwc
Microsoft Windows Generic	_ungettc

Character Manipulation Functions