getchar
[read a character (macro)]
SYNOPSIS
#include
<stdio.h>
int getchar(void);
int _getchar_r(void
*reent);
DESCRIPTION
getchar
is a macro, defined in stdio.h.
You can use getchar
to get the next single character from
the standard input stream. As a side effect, getchar
advances the standard input’s current
position indicator.
The alternate function _getchar_r is a reentrant version. The extra argument reent is a pointer to a reentrancy structure.
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, getchar
returns EOF.
You can distinguish the two situations that cause an EOF result by using ferror(stdin) and feof(stdin).
COMPLIANCE
ANSI C requires
getchar;
it suggests, but does not require, that getchar
be implemented as a macro.
Supporting OS subroutines required: close, fstat, isatty, lseek, read, sbrk, write.
0