GETC(3) NEWLIB GETC(3)NAME
4.32 `getc'--read a character (macro)
SYNOPSIS
#include <stdio.h>
int getc(FILE *FP);
#include <stdio.h>
int _getc_r(struct _reent *PTR, 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'.
The `_getc_r' function is simply the reentrant version of `getc'
which passes an additional reentrancy structure pointer argument: PTR.
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; there‐
fore, 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 ALSOgetc is part of the library. The full documentation for is maintained
as a Texinfo manual. If info and are properly installed at your site,
the command
info
will give you access to the complete manual.
NEWLIB April 2010 GETC(3)
