Scroll to navigation

MONGOC_CURSOR_SET_LIMIT(3) MongoDB C Driver MONGOC_CURSOR_SET_LIMIT(3)

NAME

mongoc_cursor_set_limit - mongoc_cursor_set_limit()

SYNOPSIS

bool
mongoc_cursor_set_limit (mongoc_cursor_t *cursor, int64_t limit);


PARAMETERS

  • cursor: A mongoc_cursor_t.
  • limit: The maximum number of documents to retrieve for this query.

DESCRIPTION

Limits the number of documents in the result set.

This function is useful for setting the limit on a cursor after the cursor is created, but before any calls to mongoc_cursor_next. It can also be used to pass a negative limit: The limit parameter to mongoc_cursor_set_limit is signed, although for backward-compatibility reasons the limit parameter to mongoc_collection_find is not.

Calling this function after mongoc_cursor_next has no effect.

This is not applicable to all cursors. Calling mongoc_cursor_set_limit 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.

RETURNS

Returns true on success. If any arguments are invalid, returns false and leaves the limit unchanged.

AUTHOR

MongoDB, Inc

COPYRIGHT

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