ungetwc(3)


NAME

   ungetwc - push back a wide character onto a FILE stream

SYNOPSIS

   #include <wchar.h>

   wint_t ungetwc(wint_t wc, FILE *stream);

DESCRIPTION

   The   ungetwc()  function  is  the  wide-character  equivalent  of  the
   ungetc(3) function.  It pushes back a wide character  onto  stream  and
   returns it.

   If wc is WEOF, it returns WEOF.  If wc is an invalid wide character, it
   sets errno to EILSEQ and returns WEOF.

   If wc 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

   The ungetwc()  function  returns  wc  when  successful,  or  WEOF  upon
   failure.

ATTRIBUTES

   For   an   explanation   of   the  terms  used  in  this  section,  see
   attributes(7).

   
   Interface  Attribute      Value   
   
   ungetwc()  Thread safety  MT-Safe 
   

CONFORMING TO

   POSIX.1-2001, POSIX.1-2008, C99.

NOTES

   The behavior of ungetwc() depends  on  the  LC_CTYPE  category  of  the
   current locale.

SEE ALSO

   fgetwc(3)

COLOPHON

   This  page  is  part of release 4.09 of the Linux man-pages project.  A
   description of the project, information about reporting bugs,  and  the
   latest     version     of     this    page,    can    be    found    at
   https://www.kernel.org/doc/man-pages/.


More Linux Commands

manpages/Tcl_UpVar2.3.html
Tcl_UpVar2(3) - link one variable to another (Man Page).....
Tcl_UpVar and Tcl_UpVar2 provide the same functionality as the upvar command: they make a link from a source variable to a destination variable, so that referen

manpages/isblank.3.html
isblank(3) - character classification routines (Man Page)...
These functions check whether c, which must have the value of an unsigned char or EOF, falls into a certain character class according to the specified locale. T

manpages/git-name-rev.1.html
git-name-rev(1) - Find symbolic names for given revs........
Finds symbolic names suitable for human digestion for revisions given in any format parsable by git rev-parse. OPTIONS --tags Do not use branch names, but only

manpages/remquof.3.html
remquof(3) - remainder and part of quotient - Linux man page
These functions compute the remainder and part of the quotient upon division of x by y. A few bits of the quotient are stored via the quo pointer. The remainder

manpages/timegm.3.html
timegm(3) - inverses of gmtime and localtime (Man Page).....
The functions timelocal() and timegm() are the inverses of localtime(3) and gmtime(3). CONFORMING TO These functions are nonstandard GNU extensions that are als

manpages/XErrorEvent.3.html
XErrorEvent(3) - X error event structure - Linux man page...
The XErrorEvent structure contains: typedef struct { int type; Display *display; /* Display the event was read from */ unsigned long serial;/* serial number of

manpages/zshzle.1.html
zshzle(1) - zsh command line editor - Linux manual page.....
If the ZLE option is set (which it is by default in interactive shells) and the shell input is attached to the terminal, the user is able to edit command lines.

manpages/gdbtui.1.html
gdbtui(1) - The GNU Debugger (Commands - Linux man page)....
The purpose of a debugger such as GDB is to allow you to see what is going on inside another program while it executes-or what another program was doing at the

manpages/set_form_userptr.3form.html
set_form_userptr(3form) - associate application data with a
set_form_userptr.3form - Every form and every form item has a field that can be used to hold application-specific data (that is, the form-driver code leaves it

manpages/pthread_attr_getdetachstate.3.html
pthread_attr_getdetachstate(3) - set/get detach state attrib
The pthread_attr_setdetachstate() function sets the detach state attribute of the thread attributes object referred to by attr to the value specified in detachs

manpages/XrmPutStringResource.3.html
XrmPutStringResource(3) - store database resources (ManPage)
If database contains NULL, XrmPutResource creates a new database and returns a pointer to it. XrmPutResource is a convenience function that calls XrmStringToBin

manpages/XkbUpdateMapFromCore.3.html
XkbUpdateMapFromCore(3) - Update a local Xkb keyboard map to
Xkb provides several functions that make it easier to apply the compatibility map to configure a client-side Xkb keyboard mapping, given a core protocol represe





We can't live, work or learn in freedom unless the software we use is free.