Updated: April 19, 2023 |
Push a wide character back onto an input stream
#include <wchar.h> wint_t ungetwc( wint_t wc, FILE * fp );
libc
Use the -l c option to qcc to link against this library. This library is usually included automatically.
The ungetwc() function pushes the wide character specified by wc back onto the input stream pointed to by fp.
The pushed-back character will be returned the next time that you read from the stream but is discarded if you call fflush() or a file-positioning function (fseek(), fsetpos(), or rewind()) before the next read operation is performed.
Only one character (the most recent one) of pushback is guaranteed.
The ungetwc() function clears the end-of-file indicator, unless the value of wc is WEOF.
The character pushed back.
Safety: | |
---|---|
Cancellation point | Yes |
Interrupt handler | No |
Signal handler | No |
Thread | Yes |