ungetwc(3) [netbsd man page]

UNGETWC(3)						   BSD Library Functions Manual 						UNGETWC(3)

NAME

     ungetwc -- un-get wide character from input stream

LIBRARY

     Standard C Library (libc, -lc)

SYNOPSIS

     #include <stdio.h>
     #include <wchar.h>

     wint_t
     ungetwc(wint_t wc, FILE *stream);

DESCRIPTION

     The ungetwc() function pushes the wide character wc (converted to an wchar_t) back onto the input stream pointed to by stream.  The pushed-
     backed wide characters will be returned by subsequent reads on the stream (in reverse order).  A successful intervening call, using the same
     stream, to one of the file positioning functions fseek(3), fsetpos(3), or rewind(3) will discard the pushed back wide characters.

     One wide character of push-back is guaranteed, but as long as there is sufficient memory, an effectively infinite amount of pushback is
     allowed.

     If a character is successfully pushed-back, the end-of-file indicator for the stream is cleared.

RETURN VALUES

     The ungetwc() function returns the wide character pushed-back after the conversion, or WEOF if the operation fails.  If the value of the
     argument c character equals WEOF, the operation will fail and the stream will remain unchanged.

SEE ALSO

     fseek(3), getwc(3)

STANDARDS

     The ungetwc() function conforms to ISO/IEC 9899:1999 (``ISO C99'').

BUGS

     The current implementation uses a fixed sized ungetwc-buffer.

BSD
								 October 24, 2001							       BSD

ungetwc(3C)						   Standard C Library Functions 					       ungetwc(3C)

NAME

       ungetwc - push wide-character code back into input stream

SYNOPSIS

       #include <stdio.h>
       #include <wchar.h>

       wint_t ungetwc(wint_t wc, FILE *stream);

DESCRIPTION

       The  ungetwc() function pushes the character corresponding to the wide character code specified by wc back onto the input stream pointed to
       by stream. The pushed-back characters will be returned by subsequent reads on that stream in the reverse order of their pushing. A success-
       ful intervening call (with the stream pointed to by stream) to a file-positioning function ( fseek(3C), fsetpos(3C) or rewind(3C)) discards
       any pushed-back characters for the stream. The external storage corresponding to the stream is unchanged.

       One character of push-back is guaranteed. If ungetwc() is called too many times on the same stream without an  intervening  read  or  file-
       positioning operation on that stream, the operation may fail.

       If the value of wc equals that of the macro WEOF, the operation fails and the input stream is unchanged.

       A  successful  call  to	ungetwc() clears the end-of-file indicator for the stream. The value of the file-position indicator for the stream
       after reading or discarding all pushed-back characters will be the same as it was before the characters were pushed back. The file-position
       indicator  is  decremented (by one or more) by each successful call to ungetwc(); if its value was 0 before a call, its value is indetermi-
       nate after the call.

RETURN VALUES

       Upon successful completion, ungetwc() returns the wide-character code corresponding to the  pushed-back	character.  Otherwise  it  returns
       WEOF.

ERRORS

       The ungetwc() function may fail if:

       EILSEQ	 An invalid character sequence is detected, or a wide-character code does not correspond to a valid character.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |ATTRIBUTE TYPE		     |ATTRIBUTE VALUE		   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       read(2), fseek(3C), fsetpos(3C), rewind(3C), setbuf(3C), attributes(5), standards(5)

SunOS 5.11							    14 Aug 2002 						       ungetwc(3C)