programming.nbk: Home | Index | Next Page: gets(char *s) | Previous Page: getc(FILE *stream)

 getchar(void)

Syntax

int getchar(void)

Description

The getchar() function gets a character from stdin. It is equivalent to getc(stdin).

Parameters

None.

Return Values

The getchar() function returns the next character from stdin. If stdin is at the end of the file, the end-of-file indicator for stdin is set and getchar() returns EOF. If a read error occurs, the error indicator for stdin is set and getchar() returns EOF. The functions feof() and ferror() can be used to distinguish error conditions from EOF.

On failure, errno is set to one of the following values:

EACCES Another process has the file locked. EBADF stdin is not a valid stream opened for reading. EINTR A signal interrupted the call. EIO An input error occurred. EISDIR The open object is a directory, rather than a file. ENOMEM Memory could not be allocated for internal buffers. ENXIO A device error occurred. EOVERFLOW The file is a regular file and an attempt was made to read at or beyond the offset maximum associated with the corresponding stream. EWOULDBLOCK The underlying file descriptor is a non-blocking socket and no data is ready to be read.

programming.nbk: Home | Index | Next Page: gets(char *s) | Previous Page: getc(FILE *stream)

Notebook exported on Monday, 7 July 2008, 18:56:06 PM Eastern Daylight Time