From 754bbf7a25a8dda49b5d08ef0d0443bbf5af0e36 Mon Sep 17 00:00:00 2001 From: Craig Jennings Date: Sun, 7 Apr 2024 13:41:34 -0500 Subject: new repository --- devdocs/c/io%2Fungetwc.html | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) create mode 100644 devdocs/c/io%2Fungetwc.html (limited to 'devdocs/c/io%2Fungetwc.html') diff --git a/devdocs/c/io%2Fungetwc.html b/devdocs/c/io%2Fungetwc.html new file mode 100644 index 00000000..88d39fd7 --- /dev/null +++ b/devdocs/c/io%2Fungetwc.html @@ -0,0 +1,27 @@ +

ungetwc

Defined in header <wchar.h> 
wint_t ungetwc( wint_t ch, FILE *stream );
+		 (since C95)

If ch does not equal WEOF, pushes the wide character ch into the input buffer associated with the stream stream in such a manner that subsequent read operation from stream will retrieve that wide character. The external device associated with the stream is not modified.

+

Stream repositioning operations fseek, fsetpos, and rewind discard the effects of ungetwc.

+

If ungetwc 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 successful ungetwc were performed, read operations retrieve the pushed-back wide characters in reverse order of ungetwc

+

If ch equals WEOF, the operation fails and the stream is not affected.

+

A successful call to ungetwc clears the end of file status flag feof.

+

A successful call to ungetwc 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 before ungetwc.

+

Parameters

+ + +
ch - wide character to be put back
stream - file stream to put the wide character back to

Return value

On success ch is returned.

+

On failure WEOF is returned and the given stream remains unchanged.

+

References

See also

+ + +
puts a character back into a file stream
(function)
+
(C95)
 gets a wide character from a file stream
(function)
C++ documentation for ungetwc
+

+ © cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
+ https://en.cppreference.com/w/c/io/ungetwc +

+
-- cgit v1.2.3