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)