GETC(3) BSD Programmer's Manual GETC(3) NNAAMMEE ffggeettcc, ggeettcc, ggeettcchhaarr, ggeettww - get next character or word from input stream SSYYNNOOPPSSIISS ##iinncclluuddee <> _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