Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

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

NAME
     buffer_get_token_sa - read token from buffer

SYNTAX
     #include <libowfat/stralloc.h>
     #include <libowfat/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 delim-
     iters 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 con-
     tain 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  in-
     dicate more data is available).

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

							  buffer_get_token_sa(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=libowfat_buffer_get_token_sa&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help