Manpage of GETC
GETC
Section: NEWLIB (3)
Updated: 2005 Feb 23
Index
Return to Main Contents
NAME
3.21 `getc'--read a character (macro)
SYNOPSIS
#include <stdio.h>
int getc(FILE *FP);
DESCRIPTION
`getc' is a macro, defined in `stdio.h'. You can use `getc' to get the
next single character from the file or stream identified by FP. As a
side effect, `getc' advances the file's current position indicator.
For a subroutine version of this macro, see `fgetc'.
RETURNS
The next character (read as an `unsigned char', and cast to `int'),
unless there is no more data, or the host system reports a read error;
in either of these situations, `getc' returns `EOF'.
You can distinguish the two situations that cause an `EOF' result by
using the `ferror' and `feof' functions.
PORTABILITY
ANSI C requires `getc'; it suggests, but does not require, that `getc'
be implemented as a macro. The standard explicitly permits macro
implementations of `getc' to use the argument more than once;
therefore, in a portable program, you should not use an expression with
side effects as the `getc' argument.
Supporting OS subroutines required: `close', `fstat', `isatty',
`lseek', `read', `sbrk', `write'.
SEE ALSO
getc
is part of the
libc
library.
The full documentation for
libc
is maintained as a Texinfo manual. If
info
and
libc
are properly installed at your site, the command
-
info libc
will give you access to the complete manual.
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- RETURNS
-
- PORTABILITY
-
- SEE ALSO
-
This document was created by
man2html,
using the manual pages.
Time: 21:25:17 GMT, May 16, 2005
www.fiveanddime.net