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	<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 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)

NAME | SYNTAX | DESCRIPTION | RETURN VALUE | RATIONALE | SEE ALSO

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

home | help