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)