getln2

Section: C Library Functions (3)
Index Return to Main Contents
 

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)


 

Index

NAME
SYNTAX
DESCRIPTION
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 18:00:51 GMT, June 16, 2008