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)