NAME

       mongoc_cursor_next()  - This function shall iterate the underlying cursor, setting bson to
       the next document.

SYNOPSIS

       bool
       mongoc_cursor_next (mongoc_cursor_t *cursor,
                           const bson_t   **bson);

PARAMETERS

       cursor A mongoc_cursor_t \&.

       bson   A location for a const bson_t * \&.

DESCRIPTION

       This function shall iterate the underlying cursor, setting bson to the next document.

       This function is a blocking function.

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(3) 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(3) \&.

COLOPHON

       This    page   is   part   of   MongoDB   C   Driver.    Please   report   any   bugs   at
       https://jira.mongodb.org/browse/CDRIVER.