debian man page for getln2

getln2(3)						     Library Functions Manual							 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 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)