On this page
This page documents a
mongoshmethod. This is not the documentation for a language-specific driver, such as Node.js.
For MongoDB API drivers, refer to the language-specific MongoDB driver documentation.
limit()method on a cursor to specify the maximum number of documents the cursor will return.
limit()is analogous to the
LIMITstatement in a SQL database.
You must apply
limit()to the cursor before retrieving any documents from the database.
limit()to maximize performance and prevent MongoDB from returning more results than required for processing.
limit()method has the following prototype form:
The behavior of
limit() is undefined for values less
than -2 31 and greater than 2 31.
You must specify a numeric value for
limit() value of 0 (i.e.
.limit(0)) is equivalent to setting no limit.
A negative limit is similar to a positive limit but closes the cursor
after returning a single batch of results. As
such, with a negative limit, if the limited result set does not fit
into a single batch, the number of documents received will be less than
the specified limit. By passing a negative limit, the client indicates
to the server that it will not ask for a subsequent batch via
sure to include at least one field in your sort that contains
unique values, before passing results to
Sorting on fields that contain duplicate values may return an inconsistent sort order for those duplicate fields over multiple executions, especially when the collection is actively receiving writes.
The easiest way to guarantee sort consistency is to include the
_id field in your sort query.
See Consistent sorting with the sort() method for more information.