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)