.TH getln 3.SH NAMEgetln \- read one line of data.SH SYNTAX.B #include <getln.h>int \fBgetln\fP(&\fIss\fR,&\fIsa\fR,&\fImatch\fR,\fIsep\fR);substdio \fIss\fR;.brstralloc \fIsa\fR;.brint \fImatch\fR;.brint \fIsep\fR;.SH DESCRIPTION.B getlnreads a line of characters, terminated by a .I sepcharacter,from.IR ss .It returns the line in.I saand sets.I matchto 1.If.B getlnsees end-of-input before it sees.IR sep ,it returns the partial line in.I saand sets.I matchto 0..B getlnnormally returns 0.If it runs out of memory,or encounters an error from.IR ss ,it returns -1,setting.B errnoappropriately..SH "SEE ALSO"stralloc(3),substdio(3),getln2(3)