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

  
 
  

home | help
MONGOC_CURSOR_MORE(3)		    libmongoc		   MONGOC_CURSOR_MORE(3)

SYNOPSIS
	bool
	mongoc_cursor_more (mongoc_cursor_t *cursor);

PARAMETERS
     * cursor: A mongoc_cursor_t.

DESCRIPTION
     This  function  shall indicate if there is potentially more data to be read
     from  the	cursor.  This  is  only  useful  with  tailable   cursors.   Use
     mongoc_cursor_next() for regular cursors.

     Details:  mongoc_cursor_more  is unreliable because it does not contact the
     server to see if there are actually more documents in the	result	set.  It
     simply  returns  true  if	the cursor has not begun, or if it has begun and
     there are buffered documents in the client-side cursor, or if it has  begun
     and the server has not yet told the cursor it is completely iterated.

     This  is  unreliable with regular queries because it returns true for a new
     cursor before iteration, even if the cursor will match no documents. It  is
     also true if the collection has been dropped on the server since the previ-
     ous fetch, or if the cursor has finished its final batch and the next batch
     will be empty.

RETURNS
     true  if  the  cursor has locally-buffered documents, or if a round-trip to
     the server might fetch additional documents.

     SEE ALSO:
	Tailable Cursor Example

AUTHOR
     MongoDB, Inc

COPYRIGHT
     2009-present, MongoDB, Inc.

1.30.8				  Aug 27, 2026		   MONGOC_CURSOR_MORE(3)

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

home | help