NAME

       getln - read one line of data

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)