getln2(3)              C Library Functions              getln2(3)



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)