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

FreeBSD Manual Pages

  
 
  

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

NAME
     buffer_get - read binary data from buffer

SYNTAX
     #include <libowfat/buffer.h>

     ssize_t buffer_get(buffer* b,char* x,size_t len);

DESCRIPTION
     Normally  buffer_get  copies data to x[0], x[1], ..., x[len-1] from the be-
     ginning of a string stored in preallocated space; removes these  len  bytes
     from the string; and returns len.

     If,  however,  the  string  has  fewer  than  len	(but more than 0) bytes,
     buffer_get copies only that many bytes, and returns that number.

     If the string is empty, buffer_get first uses a read operation to feed data
     into the string. The read operation may indicate end  of  input,  in  which
     case  buffer_get  returns	0; or a read error, in which case buffer_get re-
     turns -1, setting errno appropriately.

     The preallocated space and the read operation are specified by b. You  must
     initialize  b  using buffer_init before calling buffer_get (or use the pre-
     initialized buffer_0).

SEE ALSO
     buffer_init(3), buffer_feed(3), buffer_peek(3), buffer_seek(3), buffer(3)

								   buffer_get(3)

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

home | help