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



                                                                      getln(3)