NAME

       mongoc_cursor_next - mongoc_cursor_next()

SYNOPSIS

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

PARAMETERS

       • cursor: A mongoc_cursor_t.

       • bson: A location for a 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() 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().

AUTHOR

       MongoDB, Inc

COPYRIGHT

       2018, MongoDB, Inc