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 character, 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)

                                                                                        getln2(3)