]> git.saurik.com Git - apple/libc.git/blobdiff - stdio/FreeBSD/ungetc.3
Libc-1044.1.2.tar.gz
[apple/libc.git] / stdio / FreeBSD / ungetc.3
index ee280eb9a745add23e872d37e90fa81a90b8ffe3..169a02ba0d86c2f02673841476b2e86433f3b54a 100644 (file)
 .Sh SYNOPSIS
 .In stdio.h
 .Ft int
-.Fn ungetc "int c" "FILE *stream"
+.Fo ungetc
+.Fa "int c"
+.Fa "FILE *stream"
+.Fc
 .Sh DESCRIPTION
 The
 .Fn ungetc
@@ -52,20 +55,20 @@ function pushes the character
 (converted to an unsigned char)
 back onto the input stream pointed to by
 .Fa stream .
-The pushed-back characters will be returned by subsequent reads on the
-stream (in reverse order).
-A successful intervening call,
-using the same stream,
+The pushed-back characters will be returned (in reverse order)
+by subsequent reads on the stream.
+A successful intervening call
 to one of the file positioning functions
 .Xr ( fseek 3 ,
 .Xr fsetpos 3 ,
 or
-.Xr rewind 3 )
-will discard the pushed back characters.
+.Xr rewind 3 ) ,
+using the same stream,
+will discard the pushed-back characters.
 .Pp
-One character of push-back is guaranteed,
+Only one character of push-back is guaranteed,
 but as long as there is sufficient memory,
-an effectively infinite amount of pushback is allowed.
+an effectively infinite amount of push-back is allowed.
 .Pp
 If a character is successfully pushed-back,
 the end-of-file indicator for the stream is cleared.