UNGETC man page on SmartOS

Man page or keyword search:  
man Server   16655 pages
apropos Keyword Search (all sections)
Output format
SmartOS logo
[printable version]

UNGETC(3C)							    UNGETC(3C)

       ungetc - push byte back into input stream

       #include <stdio.h>

       int ungetc(int c, FILE *stream);

       The  ungetc()  function pushes the byte specified by c (converted to an
       unsigned char) back onto the input stream pointed to  by	 stream.   The
       pushed-back  bytes  will be returned by subsequent reads on that stream
       in the reverse order of their pushing. A	 successful  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	 bytes
       for  the	 stream.  The  external storage corresponding to the stream is

       Four bytes of push-back are guaranteed.	If ungetc() is called too many
       times  on the same stream without an intervening read or file-position‐
       ing operation on that stream, the operation may fail.

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

       A  successful call to ungetc() 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 bytes will be the same as it was
       before the bytes were  pushed  back.  The  file-position	 indicator  is
       decremented  by	each  successful  call to ungetc(); if its value was 0
       before a call, its value is indeterminate after the call.

       Upon successful completion, ungetc() returns the byte pushed back after
       conversion.  Otherwise it returns EOF.

       No errors are defined.

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

       │Interface Stability │ Standard	      │
       │MT-Level	    │ MT-Safe	      │

       read(2), Intro(3), __fsetlocking(3C), fseek(3C), fsetpos(3C), getc(3C),
       setbuf(3C), stdio(3C), attributes(5), standards(5)

				 Sep 10, 2003			    UNGETC(3C)

List of man pages available for SmartOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
Vote for polarhome
Free Shell Accounts :: the biggest list on the net