MAN PAGES FOR QMAIL 1.03

NAME

     getln - read one line of data

SYNTAX

     #include <getln.h>

     int getln(&ss,&sa,&match,sep);

     substdio ss;
     stralloc sa;
     int match;
     int sep;

DESCRIPTION

     getln reads a line of characters, terminated by a sep  char-
     acter, from ss.  It returns the line in sa and sets match to
     1.

     If getln sees end-of-input before it sees  sep,  it  returns
     the partial line in sa and sets match to 0.

     getln normally returns 0.  If it  runs  out  of  memory,  or
     encounters  an  error  from ss, it returns -1, setting errno
     appropriately.

SEE ALSO

     stralloc(3), substdio(3), getln2(3)