1MONGOC_CURSOR_MORE(3)              libmongoc             MONGOC_CURSOR_MORE(3)
2
3
4

SYNOPSIS

6          bool
7          mongoc_cursor_more (mongoc_cursor_t *cursor);
8

PARAMETERS

10       • cursor: A mongoc_cursor_t.
11

DESCRIPTION

13       This  function  shall  indicate if there is potentially more data to be
14       read from the cursor. This is only useful with  tailable  cursors.  Use
15       mongoc_cursor_next() for regular cursors.
16
17       Details:  mongoc_cursor_more  is unreliable because it does not contact
18       the server to see if there are actually more documents  in  the  result
19       set.  It  simply returns true if the cursor has not begun, or if it has
20       begun and there are buffered documents in the client-side cursor, or if
21       it  has  begun  and  the  server has not yet told the cursor it is com‐
22       pletely iterated.
23
24       This is unreliable with regular queries because it returns true  for  a
25       new  cursor  before  iteration,  even if the cursor will match no docu‐
26       ments. It is also true if the collection has been dropped on the server
27       since the previous fetch, or if the cursor has finished its final batch
28       and the next batch will be empty.
29

RETURNS

31       true if the cursor has locally-buffered documents, or if  a  round-trip
32       to the server might fetch additional documents.
33
34       SEE ALSO:
35          Tailable Cursor Example
36
37

AUTHOR

39       MongoDB, Inc
40

42       2017-present, MongoDB, Inc
43
44
45
46
471.25.1                           Nov 08, 2023            MONGOC_CURSOR_MORE(3)
Impressum