hpux man page for ungetwc

ungetwc(3C)															       ungetwc(3C)

NAME
       ungetwc()  - push a wide character back into an input stream

SYNOPSIS
   Obsolescent Interface
   Remarks:
       This  function  is  compliant with the XPG4 Worldwide Portability Interface 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 ALSO
       flockfile(3S), fseek(3S), fgetpos(3S), getwc(3C), setbuf(3S), orientation(5), thread_safety(5).

STANDARDS CONFORMANCE
																       ungetwc(3C)