FGETC(3) NEWLIB 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 cur‐
rent 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 ALSOfgetc 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 FGETC(3)