man getln (3): read one line of data

SYNTAX

#include <getln.h>

int getln(&ss,&sa,&match,sep);

substdio ss;
stralloc sa;
int match;
int sep;

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.