Scroll to navigation

MONGOC_CURSOR_SET_MAX_AWAIT_TIME_MS(3) MongoDB C Driver MONGOC_CURSOR_SET_MAX_AWAIT_TIME_MS(3)

NAME

mongoc_cursor_set_max_await_time_ms - mongoc_cursor_set_max_await_time_ms()

SYNOPSIS

void
mongoc_cursor_set_max_await_time_ms (mongoc_cursor_t *cursor,
                                     uint32_t max_await_time_ms);


PARAMETERS

  • cursor: A mongoc_cursor_t.
  • max_await_time_ms: A timeout in milliseconds.

DESCRIPTION

The maximum amount of time for the server to wait on new documents to satisfy a tailable cursor query. Only applies if the cursor is created from mongoc_collection_find_with_opts with "tailable" and "awaitData" options, and the server is MongoDB 3.2 or later. See the documentation for maxTimeMS and the "getMore" command.

The max_await_time_ms cannot be changed after the first call to mongoc_cursor_next.

This is not applicable to all cursors. Calling mongoc_cursor_set_batch_size on a cursor returned by mongoc_client_find_databases_with_opts, mongoc_database_find_collections_with_opts, or mongoc_collection_find_indexes_with_opts will not change the results.

Note: although max_await_time_ms is a uint32_t, it is possible to set it as a uint64_t through the options arguments in some cursor returning functions like mongoc_collection_find_with_opts().

SEE ALSO

Tailable Cursors.

AUTHOR

MongoDB, Inc

COPYRIGHT

2017-present, MongoDB, Inc
February 23, 2019 1.14.0