ungetwc(3C)ungetwc(3C)NAMEungetwc() - push a wide character back into an input stream
SYNOPSIS
Obsolescent Interface
Remarks:
This function is compliant with the XPG4 Worldwide Portability Inter‐
face wide-character I/O functions. It parallels the 8-bit character
I/O function defined in ungetc(3S).
DESCRIPTION
pushes the character corresponding to the wide-character code wc into
the buffer associated with an input stream. That wide-character code,
wc, is returned by the next call to (see getwc(3C)) on that stream. A
successful intervening call to a file positioning function with stream
or erases all memory of the pushed-back characters.
affects only the buffer associated with the input stream. It does not
affect the contents of the file corresponding to stream.
One character of pushback is guaranteed.
If wc equals does nothing to the buffer and returns
The definition for this function, the type and the value are provided
in the header.
Obsolescent Interface
pushes a wide character back into an input stream.
APPLICATION USAGE
After is applied to a stream, the stream becomes wide-oriented (see
orientation(5)).
EXTERNAL INFLUENCES
Locale
The category determines how wide character conversions are done.
International Code Set Support
Single- and multi-byte character code sets are supported.
RETURN VALUE
If successful, and return wc and clear the end-of-file indicator for
the stream. and return if they cannot insert the wide character.
WARNINGS
is an obsolescent interface supported only for compatibility with
existing DCE applications. New multithreaded applications should use
AUTHOR
and were developed by OSF and HP.
SEE ALSOflockfile(3S), fseek(3S), fgetpos(3S), getwc(3C), setbuf(3S), orienta‐
tion(5), thread_safety(5).
STANDARDS CONFORMANCEungetwc(3C)