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

  
 
  

home | help
MONGOC_STREAM_READ(3)		    libmongoc		   MONGOC_STREAM_READ(3)

SYNOPSIS
	ssize_t
	mongoc_stream_read (mongoc_stream_t *stream,
			    void *buf,
			    size_t count,
			    size_t min_bytes,
			    int32_t timeout_msec);

PARAMETERS
     * stream: A mongoc_stream_t.

     * buf: The buffer to read into.

     * count: The number of bytes to read.

     * min_bytes: The minimum number of bytes to read, or else indicate failure.

     * timeout_msec:  The number of milliseconds to wait before failure, a time-
       out of 0 will not block. If negative, use the default timeout.

     The  mongoc_stream_read()	function   shall   perform   a	 read	from   a
     mongoc_stream_t.  It's  modeled  on the API and semantics of read(), though
     the parameters map only loosely.

     WARNING:
	The "default timeout" indicated by a negative value is both  unspecified
	and  unrelated	to  the documented default values for *TimeoutMS URI op-
	tions.	To specify a default timeout value for a *TimeoutMS URI  option,
	use the MONGOC_DEFAULT_* constants defined in mongoc-client.h.

RETURNS
     The  mongoc_stream_read() function returns the number of bytes read on suc-
     cess. It returns >= 0 and < min_bytes when end-of-file is	encountered  and
     -1 on failure. errno is set upon failure.

     SEE ALSO:
	mongoc_stream_readv()

	mongoc_stream_write()

	mongoc_stream_writev()

AUTHOR
     MongoDB, Inc

COPYRIGHT
     2009-present, MongoDB, Inc.

1.30.8				  Aug 27, 2026		   MONGOC_STREAM_READ(3)

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

home | help