GETLIN(3F)          UNIX Programmer's Manual           GETLIN(3F)

NAME
     getlin - read next line from a file

SYNTAX
     character*(L) line
     integer fileid, getlin, n
     n = getlin(line, fileid)

DESCRIPTION
     _G_e_t_l_i_n_e reads one line into the character string _l_i_n_e, and
     returns the number of characters read as its function value.
     _G_e_t_l_i_n will not read more characters than will fit into
     _l_i_n_e.  If a newline is encountered, _g_e_t_l_i_n returns the
     number of characters up to and including the newline.

     _F_i_l_e_i_d is the integer returned from a successful _o_p_e_n(3F) or
     _c_r_e_a_t_e(3F).

SEE ALSO
     create(3F), open(3F), putlin(3F)

DIAGNOSTICS
     The integer constant -1 is returned upon end of input.

AUTHOR
     Bruce Julian, U.S. Geological Survey, Menlo Park, California

Printed 5/17/83                                                 1