2 .\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
4 .\" SPDX-License-Identifier: GPL-2.0-or-later
6 .\" References consulted:
7 .\" GNU glibc-2 source code and manual
8 .\" Dinkumware C library reference http://www.dinkumware.com/
9 .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
12 .TH ungetwc 3 (date) "Linux man-pages (unreleased)"
14 ungetwc \- push back a wide character onto a FILE stream
17 .RI ( libc ", " \-lc )
22 .BI "wint_t ungetwc(wint_t " wc ", FILE *" stream );
27 function is the wide-character equivalent of the
30 It pushes back a wide character onto
42 is an invalid wide character,
52 is a valid wide character, it is pushed back onto the stream
53 and thus becomes available for future wide-character read operations.
54 The file-position indicator is decremented by one or more.
57 The backing storage of the file is not affected.
61 need not be the last wide-character read from the stream;
62 it can be any other valid wide character.
64 If the implementation supports multiple push-back operations in a row, the
65 pushed-back wide characters will be read in reverse order; however, only one
66 level of push-back is guaranteed.
77 For an explanation of the terms used in this section, see
85 Interface Attribute Value
88 T} Thread safety MT-Safe