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

       2017-present, MongoDB, Inc

1.26.0                                            Mar 31, 2024                             MONGOC_CURSOR_MORE(3)