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 de-
       limiters	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_to-
       ken_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)

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+14.3.quarterly>

home | help