@(#)getc.3 5.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 (in a 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 (3S) should be used to check the success of getw . Getw assumes no special alignment in the file.

fopen(3S), putc(3S), gets(3S), scanf(3S), fread(3S), ungetc(3S) 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.