getchar()

get a character from the standard input 

Function

SYNOPSIS

#include <stdio.h>

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.

CONFORMANCE

ANSI/ISO 9899-1990

MULTITHREAD SAFETY LEVEL

MT-Safe.

PORTING ISSUES

The routine getchar() is implemented as a macro, and hence cannot be used as the value of a pointer to a function.

If the stream is from a file opened in text mode, the line-terminating character sequence carriage return plus linefeed is translated to linefeed. No such translation occurs for files opened in binary mode.

AVAILABILITY

PTC MKS Toolkit for Professional Developers
PTC MKS Toolkit for Professional Developers 64-Bit Edition
PTC MKS Toolkit for Enterprise Developers
PTC MKS Toolkit for Enterprise Developers 64-Bit Edition

SEE ALSO

Functions:
feof(), ferror(), fgetc(), fopen(), getc(), getc_unlocked(), getchar_unlocked()

PTC MKS Toolkit 10.5 Documentation Build 40.