@(#)getc.3 4.1 (Berkeley) 05/15/85

.AT 3 getc, getchar, fgetc, getw - get character or word from stream #include <stdio.h>

int getc(stream)

FILE *stream;

int getchar()

int fgetc(stream)

FILE *stream;

int getw(stream)

FILE *stream;

Getc returns the next character from the named input stream .

Getchar() is identical to getc(stdin) .

Fgetc behaves like getc, but is a genuine function, not a macro; it may be used to save object text.

Getw returns the next word (32-bit integer on a VAX-11) from the named input stream . It returns the constant EOF upon end of file or error, but since that is a good integer value, feof and ferror (3) should be used to check the success of getw . Getw assumes no special alignment in the file.

fopen(3), putc(3), gets(3), scanf(3), fread(3), ungetc(3) These functions return the integer constant EOF at end of file or upon read error.

A stop with message, `Reading bad file', means an attempt has been made to read from a stream that has not been opened for reading by fopen .

The end-of-file return from getchar is incompatible with that in UNIX editions 1-6.

Because it is implemented as a macro, getc treats a stream argument with side effects incorrectly. In particular, `getc(*f++);' doesn't work sensibly.