fgetchar()

get a character from stdin

Synopsis:

#include <stdio.h>
int fgetchar( void );

Description:

The fgetchar() function is equivalent to fgetc() with the argument stdin.

Returns:

The next character from the input stream pointed to by stdin. If the stream is at end-of-file, the end-of-file indicator is set, and the function returns EOF. If a read error occurs, the error indicator is set, and the function returns EOF.

When an error occurs, the global variable errno contains a value indicating the type of error that has been detected.

Examples:

#include <stdio.h>

void main()
  {
    FILE *fp;
    int c;

    fp = freopen( "file", "r", stdin );
    if( fp != NULL ) {
      while( (c = fgetchar()) != EOF )
        fputchar(c);
      fclose( fp );
    }
  }

Classification:

WATCOM

See also:

errno, fgetc(), fgets(), fopen(), getc(), getchar(), gets(), ungetc()