FGETC(3)

NAME
4.10 `fgetc'--get a character from a file or stream

SYNOPSIS
     #include <stdio.h>
     int fgetc(FILE *FP);
     #include <stdio.h>
     int _fgetc_r(struct _reent *PTR, FILE *FP);

DESCRIPTION
Use `fgetc' to get the next single character from the file or stream identified by FP. As a side effect, `fgetc' advances the file's current position indicator.
   For a macro version of this function, see `getc'.
   The function `_fgetc_r' is simply a reentrant version of `fgetc' that is passed the additional reentrant 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, `fgetc' returns `EOF'.
   You can distinguish the two situations that cause an `EOF' result by using the `ferror' and `feof' functions.

PORTABILITY
ANSI C requires `fgetc'.
   Supporting OS subroutines required: `close', `fstat', `isatty', `lseek', `read', `sbrk', `write'.

SEE ALSO
fgetc 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.