bool
Contents
Copyright
2009-present, MongoDB, Inc.
1.30.4 Jun 08, 2025 MONGOC_CURSOR_NEXT(3)
Description
This function shall iterate the underlying cursor, setting bson to the next document.
This function is a blocking function.
Lifecycle
The bson objects set in this function are ephemeral and good until the next call. This means that you
must copy the returned bson if you wish to retain it beyond the lifetime of a single call to
mongoc_cursor_next().
Parameters
• cursor: A mongoc_cursor_t.
• bson: A location for a bson_t.
Returns
This function returns true if a valid bson document was read from the cursor. Otherwise, false if there
was an error or the cursor was exhausted.
Errors can be determined with the mongoc_cursor_error() function.
Synopsis
bool
mongoc_cursor_next (mongoc_cursor_t *cursor, const bson_t **bson);
