Movatterモバイル変換

ungetwc(3) — Linux manual page

NAME \|LIBRARY \|SYNOPSIS \|DESCRIPTION \|RETURN VALUE \|ATTRIBUTES \|STANDARDS \|HISTORY \|NOTES \|SEE ALSO \|COLOPHON

ungetwc(3)               Library Functions Manualungetwc(3)

NAME top

       ungetwc - push back a wide character onto a FILE stream

LIBRARY top

       Standard C library (libc,-lc)

SYNOPSIS top

#include <wchar.h>wint_t ungetwc(wint_twc, FILE *stream);

DESCRIPTION top

       Theungetwc() function is the wide-character equivalent of theungetc(3) function.  It pushes back a wide character ontostream       and returns it.       Ifwc isWEOF, it returnsWEOF.  Ifwc is an invalid wide       character, it setserrno toEILSEQand returnsWEOF.       Ifwc is a valid wide character, it is pushed back onto the stream       and thus becomes available for future wide-character read       operations.  The file-position indicator is decremented by one or       more.  The end-of-file indicator is cleared.  The backing storage       of the file is not affected.       Note:wc need not be the last wide-character read from the stream;       it can be any other valid wide character.       If the implementation supports multiple push-back operations in a       row, the pushed-back wide characters will be read in reverse       order; however, only one level of push-back is guaranteed.

RETURN VALUE top

       Theungetwc() function returnswc when successful, orWEOFupon       failure.

ATTRIBUTES top

       For an explanation of the terms used in this section, seeattributes(7).       ┌──────────────────────────────────────┬───────────────┬─────────┐       │Interface│Attribute│Value│       ├──────────────────────────────────────┼───────────────┼─────────┤       │ungetwc()                            │ Thread safety │ MT-Safe │       └──────────────────────────────────────┴───────────────┴─────────┘

STANDARDS top

       C11, POSIX.1-2008.

HISTORY top

       POSIX.1-2001, C99.

NOTES top

       The behavior ofungetwc() depends on theLC_CTYPEcategory of the       current locale.

COLOPHON top

       This page is part of theman-pages (Linux kernel and C library       user-space interface documentation) project.  Information about       the project can be found at        ⟨https://www.kernel.org/doc/man-pages/⟩.  If you have a bug report       for this manual page, see       ⟨https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git/tree/CONTRIBUTING⟩.       This page was obtained from the tarball man-pages-6.15.tar.gz       fetched from       ⟨https://mirrors.edge.kernel.org/pub/linux/docs/man-pages/⟩ on       2025-08-11.  If you discover any rendering problems in this HTML       version of the page, or you believe there is a better or more up-       to-date source for the page, or you have corrections or       improvements to the information in this COLOPHON (which isnot       part of the original manual page), send a mail to       man-pages@man7.orgLinux man-pages 6.15            2025-05-17ungetwc(3)

Pages that refer to this page:fgetc(3), fgetwc(3), gets(3)

HTML rendering created 2025-09-06 byMichael Kerrisk, author ofThe Linux Programming Interface.

For details of in-depthLinux/UNIX system programming training courses that I teach, lookhere.

Hosting byjambit GmbH.