4.4BSD/usr/share/man/cat3/getw.0

GETC(3)                     BSD Programmer's Manual                    GETC(3)

NNAAMMEE
     ffggeettcc, ggeettcc, ggeettcchhaarr, ggeettww - get next character or word from input stream

SSYYNNOOPPSSIISS
     ##iinncclluuddee <<ssttddiioo..hh>>

     _i_n_t
     ffggeettcc(_F_I_L_E _*_s_t_r_e_a_m);

     _i_n_t
     ggeettcc(_F_I_L_E _*_s_t_r_e_a_m);

     _i_n_t
     ggeettcchhaarr();

     _i_n_t
     ggeettww(_F_I_L_E _*_s_t_r_e_a_m);

DDEESSCCRRIIPPTTIIOONN
     The ffggeettcc() function obtains the next input character (if present) from
     the stream pointed at by _s_t_r_e_a_m, or the next character pushed back on the
     stream via ungetc.

     The ggeettcc() function acts essentially identically to ffggeettcc(), but is a
     macro that expands in-line.

     The ggeettcchhaarr() function is equivalent to: getc with the argument stdin.

     The ggeettww() function obtains the next _i_n_t (if present) from the stream
     pointed at by _s_t_r_e_a_m.

RREETTUURRNN VVAALLUUEESS
     If successful, these routines return the next requested object from the
     _s_t_r_e_a_m. If the stream is at end-of-file or a read error occurs, the rou-
     tines return EOF. The routines feof(3) and ferror(3) must be used to dis-
     tinguish between end-of-file and error.  If an error occurs, the global
     variable _e_r_r_n_o is set to indicate the error.  The end-of-file condition
     is remembered, even on a terminal, and all subsequent attempts to read
     will return EOF until the condition is cleared with clearerr.

SSEEEE AALLSSOO
     ferror(3),  fread(3),  fopen(3),  putc(3),  ungetc(3)

SSTTAANNDDAARRDDSS
     The ffggeettcc(), ggeettcc() and ggeettcchhaarr() functions conform to ANSI C X3.159-1989
     (``ANSI C '').

BBUUGGSS
     Since EOF is a valid integer value, feof and ferror must be used to check
     for failure after calling ggeettww().  The size and byte order of an _i_n_t
     varies from one machine to another, and ggeettww() is not recommended for
     portable applications.

4.4BSD                           June 4, 1993                                1