getc(3s) [v7 man page]

GETC(3S)																  GETC(3S)

NAME

       getc, getchar, fgetc, getw - get character or word from stream

SYNOPSIS

       #include <stdio.h>

       int getc(stream)
       FILE *stream;

       int getchar()

       int fgetc(stream)
       FILE *stream;

       int getw(stream)
       FILE *stream;

DESCRIPTION

       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 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.

SEE ALSO

       fopen(3), putc(3), gets(3), scanf(3), fread(3), ungetc(3)

DIAGNOSTICS

       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.

BUGS

       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.

																	  GETC(3S)

GETC(3S)																  GETC(3S)

NAME

       getc, getchar, fgetc, getw - get character or word from stream

SYNOPSIS

       #include <stdio.h>

       int getc(stream)
       FILE *stream;

       int getchar()

       int fgetc(stream)
       FILE *stream;

       int getw(stream)
       FILE *stream;

DESCRIPTION

       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  int  (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.

SEE ALSO

       clearerr(3S), fopen(3S), putc(3S), gets(3S), scanf(3S), fread(3S), ungetc(3S)

DIAGNOSTICS

       These  functions  return  the  integer  constant EOF at end of file, upon read error, or if an attempt is made to read a file not opened by
       fopen.  The end-of-file condition is remembered, even on a terminal, and all subsequent attempts to read will return EOF until  the  condi-
       tion is cleared with clearerr(3S).

BUGS

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

7th Edition							   May 14, 1986 							  GETC(3S)