home | help
buffer_get_new_token_sa(3)  Library Functions Manual  buffer_get_new_token_sa(3)

NAME
     buffer_get_new_token_sa - read token from buffer

SYNTAX
     #include <libowfat/stralloc.h>
     #include <libowfat/buffer.h>

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

DESCRIPTION
     buffer_get_new_token_sa  copies  data from the b to sa until one of the de-
     limiters in charset is found, overwriting the previous content of sa.  That
     delimiter is also copied to sa.

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

     If you want to read from a non-blocking socket, use buffer_get_token_sa in-
     stead.

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

SEE ALSO
     buffer_getline_sa(3), buffer_get_token(3), buffer(3)

						      buffer_get_new_token_sa(3)

home | help