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

FreeBSD Manual Pages

  
 
  

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  com-
       pletely iterated.

       This  is	 unreliable with regular queries because it returns true for a
       new cursor before iteration, even if the	cursor	will  match  no	 docu-
       ments. It is also true if the collection	has been dropped on the	server
       since the previous 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.2				 Apr 12, 2025		 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+14.3.quarterly>

home | help