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_new_token_sa_pred(3) 			     Library Functions Manual				   buffer_get_new_token_sa_pred(3)

NAME

       buffer_get_new_token_sa_pred - read token from buffer

SYNTAX

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

       int buffer_get_new_token_sa_pred(buffer* b,stralloc* sa,
			int (*predicate)(stralloc* * sa));

DESCRIPTION

       buffer_get_token_sa_pred copies data from b to sa until predicate(sa) returns 1 or -1.

       If  predicate returns 1 once a '
' was read, that new-line character is still appended to sa -- use stralloc_chop or stralloc_chomp to get
       rid of it.  predicate can also return 0 (indicating further input is required to complete the token) or -1 (abort and return -1;  use  this
       if predicate wants to enfore a maximum message size or does timeout handling or detects a malformed message).

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

       On success, buffer_get_new_token_sa_pred returns 0.

       If you want to read from a non-blocking socket, use buffer_get_token_sa_pred instead.

SEE ALSO

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

														   buffer_get_new_token_sa_pred(3)