getln(3) [debian man page]

getln(3)						     Library Functions Manual							  getln(3)

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)

																	  getln(3)

buffer_get_token_sa(3)					     Library Functions Manual					    buffer_get_token_sa(3)

NAME

       buffer_get_token_sa - read token from buffer

SYNTAX

       #include <stralloc.h>
       #include <buffer.h>

       int buffer_get_token_sa(buffer* b,stralloc* sa,
			   const char* charset,size_t setlen);

DESCRIPTION

       buffer_get_token_sa  appends data from the b to sa until one of the delimiters in charset is found, NOT overwriting the previous content of
       sa.  That delimiter is also appended to sa.

       If reading from the buffer or allocating memory fails, buffer_get_token_sa returns -1 and sets errno appropriately.  At that point  sa  may
       already contain a partial token.

RETURN VALUE

       -1 on error (setting errno), 0 on EOF, 1 when successful.

RATIONALE

       buffer_get_token_sa  appends  instead of overwriting so it can be used on non-blocking sockets (these signal error and set errno to EAGAIN;
       in this case you can simply call buffer_get_token_sa again when select or poll indicate more data is available).

SEE ALSO

       buffer_getline_sa(3), buffer_get_token(3), buffer(3)

															    buffer_get_token_sa(3)