man(1) Manual page archive


     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 (32-bit integer on a VAX) 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.

     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.