| Types and objects | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Defined in header <wchar.h> | ||
wint_t ungetwc( wint_t ch,FILE*stream); | (since C95) | |
Ifch does not equalWEOF, pushes the wide characterch into the input buffer associated with the streamstream in such a manner that subsequent read operation fromstream will retrieve that wide character. The external device associated with the stream is not modified.
Stream repositioning operationsfseek,fsetpos, andrewind discard the effects ofungetwc.
Ifungetwc is called more than once without an intervening read or repositioning, it may fail (in other words, a pushback buffer of size 1 is guaranteed, but any larger buffer is implementation-defined). If multiple successfulungetwc were performed, read operations retrieve the pushed-back wide characters in reverse order ofungetwc
Ifch equalsWEOF, the operation fails and the stream is not affected.
A successful call toungetwc clears the end of file status flagfeof.
A successful call toungetwc on a stream (whether text or binary) modifies the stream position indicator in unspecified manner but guarantees that after all pushed-back wide characters are retrieved with a read operation, the stream position indicator is equal to its value beforeungetwc.
Contents |
| ch | - | wide character to be put back |
| stream | - | file stream to put the wide character back to |
On successch is returned.
On failureWEOF is returned and the given stream remains unchanged.
| puts a character back into a file stream (function)[edit] | |
(C95) | gets a wide character from a file stream (function)[edit] |
C++ documentation forungetwc | |
