MAN PAGES FOR QMAIL 1.03

NAME

     getln2 - read one line of data

SYNTAX

     #include <getln.h>

     int getln2(&ss,&sa,&cont,&clen,sep);

     substdio ss;
     stralloc sa;
     char *cont;
     unsigned int clen;
     int sep;

DESCRIPTION

     getln2 reads a line of characters, terminated by a sep char-
     acter, from ss.

     The line is returned in two  pieces.   The  first  piece  is
     stored  in  sa.  The second piece is cont, a pointer to clen
     characters inside the ss buffer.  The second piece  must  be
     copied somewhere else before ss is used again.

     If getln2 sees end-of-input before it sees sep, it sets clen
     to  0  and does not set cont.  It puts the partial line into
     sa.

     getln2 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), getln(3)