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.

MongoDB C Driver                                   2016‐01‐18                              MONGOC_CURSOR_NEXT(3)