debian man page for buffer_get_token_sa

Query: buffer_get_token_sa

OS: debian

Section: 3

Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar

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)
Related Man Pages
io_pipe(3) - debian
vrb_read(3) - debian
ldns_bget_token(3) - centos
ldns_bskipcs(3) - centos
openpam_straddch(3) - freebsd
Similar Topics in the Unix Linux Community
Installing Dash Shell on OS X Lion
Introduction
Detecting unused variables...
My first PERL incarnation... Audio Oscillograph