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.

RETURNS

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

AUTHOR

       MongoDB, Inc

COPYRIGHT

       2018, MongoDB, Inc