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

SEE ALSO

38       Tailable Cursor Example
39

AUTHOR

41       MongoDB, Inc
42

44       2017-present, MongoDB, Inc
45
46
47
48
491.16.2                           Feb 25, 2020            MONGOC_CURSOR_MORE(3)
Impressum