GETCHAR(3)

NAME
4.34 `getchar'--read a character (macro)

SYNOPSIS
     #include <stdio.h>
     int getchar(void);
     int _getchar_r(struct _reent *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)''.

PORTABILITY
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'.

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