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

NAME

6       mongoc_cursor_more - mongoc_cursor_more()
7

SYNOPSIS

9          bool
10          mongoc_cursor_more (mongoc_cursor_t *cursor);
11

PARAMETERS

13       • cursor: A mongoc_cursor_t.
14

DESCRIPTION

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

RETURNS

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

AUTHOR

42       MongoDB, Inc
43

45       2017-present, MongoDB, Inc
46
47
48
49
501.23.1                           Oct 20, 2022            MONGOC_CURSOR_MORE(3)
Impressum