Class representing the optional arguments to a MongoDB query. More...

#include <find.hpp>

Public Member Functions
find &	allow_partial_results (bool allow_partial)
	Sets whether to allow partial results from a mongos if some shards are down (instead of throwing an error).

const stdx::optional< bool > &	allow_partial_results () const
	Gets the current setting for allowing partial results from mongos.

find &	batch_size (std::int32_t batch_size)
	Sets the number of documents to return per batch.

const stdx::optional< std::int32_t > &	batch_size () const
	The current batch size setting.

find &	comment (bsoncxx::string::view_or_value comment)
	Attaches a comment to the query.

const stdx::optional< bsoncxx::string::view_or_value > &	comment () const
	Gets the current comment attached to this query.

find &	cursor_type (cursor::type cursor_type)
	Indicates the type of cursor to use for this query.

const stdx::optional< cursor::type > &	cursor_type () const
	Gets the current cursor type.

find &	hint (class hint index_hint)
	Sets the index to use for this operation.

const stdx::optional< class hint > &	hint () const
	Gets the current hint.

find &	limit (std::int32_t limit)
	Sets maximum number of documents to return.

const stdx::optional< std::int32_t > &	limit () const
	Gets the current limit.

find &	max_await_time (std::chrono::milliseconds max_await_time)
	The maximum amount of time for the server to wait on new documents to satisfy a tailable cursor query.

const stdx::optional< std::chrono::milliseconds > &	max_await_time () const
	The maximum amount of time for the server to wait on new documents to satisfy a tailable cursor query.

find &	max_time (std::chrono::milliseconds max_time)
	Sets the maximum amount of time for this operation to run (server-side) in milliseconds.

const stdx::optional< std::chrono::milliseconds > &	max_time () const
	The current max_time_ms setting.

find &	modifiers (bsoncxx::document::view_or_value modifiers)
	Sets the meta-operators modifying the output or behavior of the query.

const stdx::optional< bsoncxx::document::view_or_value > &	modifiers () const
	Gets the current query modifiers.

find &	no_cursor_timeout (bool no_cursor_timeout)
	Sets the cursor flag to prevent cursor from timing out server-side due to a period of inactivity.

const stdx::optional< bool > &	no_cursor_timeout () const
	Gets the current no_cursor_timeout setting.

find &	projection (bsoncxx::document::view_or_value projection)
	Sets a projection which limits the returned fields for all matching documents.

const stdx::optional< bsoncxx::document::view_or_value > &	projection () const
	Gets the current projection set on this query.

find &	read_preference (class read_preference rp)
	Sets the read_preference for this operation.

const stdx::optional< class read_preference > &	read_preference () const
	The current read_preference for this operation.

find &	skip (std::int32_t skip)
	Sets the number of documents to skip before returning results.

const stdx::optional< std::int32_t > &	skip () const
	Gets the current number of documents to skip.

find &	sort (bsoncxx::document::view_or_value ordering)
	The order in which to return matching documents.

const stdx::optional< bsoncxx::document::view_or_value > &	sort () const
	Gets the current sort ordering for this query.

Detailed Description

Class representing the optional arguments to a MongoDB query.

Member Function Documentation

◆ allow_partial_results() [1/2]

const stdx::optional< bool > & mongocxx::options::find::allow_partial_results ( ) const

Gets the current setting for allowing partial results from mongos.

Returns: Whether partial results from mongos are allowed.

See also: http://docs.mongodb.org/meta-driver/latest/legacy/mongodb-wire-protocol/#op-query

◆ allow_partial_results() [2/2]

find & mongocxx::options::find::allow_partial_results ( bool allow_partial )

Sets whether to allow partial results from a mongos if some shards are down (instead of throwing an error).

Parameters

allow_partial Whether to allow partial results from mongos.

See also: http://docs.mongodb.org/meta-driver/latest/legacy/mongodb-wire-protocol/#op-query

◆ batch_size() [1/2]

const stdx::optional< std::int32_t > & mongocxx::options::find::batch_size ( ) const

The current batch size setting.

Returns: The current batch size.

See also: http://docs.mongodb.org/manual/reference/method/cursor.batchSize/

◆ batch_size() [2/2]

find & mongocxx::options::find::batch_size ( std::int32_t batch_size )

Sets the number of documents to return per batch.

Parameters

batch_size The size of the batches to request.

See also: http://docs.mongodb.org/manual/reference/method/cursor.batchSize/

◆ comment() [1/2]

const stdx::optional< bsoncxx::string::view_or_value > & mongocxx::options::find::comment ( ) const

Gets the current comment attached to this query.

Returns: The comment attached to this query.

See also: http://docs.mongodb.org/manual/reference/operator/meta/comment/

◆ comment() [2/2]

find & mongocxx::options::find::comment ( bsoncxx::string::view_or_value comment )

Attaches a comment to the query.

If $comment also exists in the modifiers document then the comment field overwrites $comment.

Parameters

comment The comment to attach to this query.

See also: http://docs.mongodb.org/manual/reference/operator/meta/comment/

◆ cursor_type() [1/2]

const stdx::optional< cursor::type > & mongocxx::options::find::cursor_type ( ) const

Gets the current cursor type.

Returns: The current cursor type.

See also: http://docs.mongodb.org/meta-driver/latest/legacy/mongodb-wire-protocol/#op-query

◆ cursor_type() [2/2]

find & mongocxx::options::find::cursor_type ( cursor::type cursor_type )

Indicates the type of cursor to use for this query.

Parameters

cursor_type The cursor type to set.

See also: http://docs.mongodb.org/meta-driver/latest/legacy/mongodb-wire-protocol/#op-query

◆ hint() [1/2]

const stdx::optional< class hint > & mongocxx::options::find::hint ( ) const

Gets the current hint.

Returns: The current hint, if one is set.

◆ hint() [2/2]

find & mongocxx::options::find::hint ( class hint index_hint )

Sets the index to use for this operation.

See also: https://docs.mongodb.org/manual/reference/operator/meta/hint/

Note: if the server already has a cached shape for this query, it may ignore a hint.

Parameters

index_hint Object representing the index to use.

◆ limit() [1/2]

const stdx::optional< std::int32_t > & mongocxx::options::find::limit ( ) const

Gets the current limit.

Returns: The current limit.

◆ limit() [2/2]

find & mongocxx::options::find::limit ( std::int32_t limit )

Sets maximum number of documents to return.

Parameters

limit The maximum number of documents to return.

◆ max_await_time() [1/2]

const stdx::optional< std::chrono::milliseconds > & mongocxx::options::find::max_await_time ( ) const

The maximum amount of time for the server to wait on new documents to satisfy a tailable cursor query.

Returns: The current max await time (in milliseconds).

◆ max_await_time() [2/2]

find & mongocxx::options::find::max_await_time ( std::chrono::milliseconds max_await_time )

The maximum amount of time for the server to wait on new documents to satisfy a tailable cursor query.

This only applies to a TAILABLE_AWAIT cursor. When the cursor is not a TAILABLE_AWAIT cursor, this option is ignored. The default on the server is to wait for one second.

Note: On servers < 3.2, this option is ignored.

Parameters

max_await_time The max amount of time (in milliseconds) to wait for new documents.

See also: http://docs.mongodb.org/manual/reference/operator/meta/maxTimeMS

◆ max_time() [1/2]

const stdx::optional< std::chrono::milliseconds > & mongocxx::options::find::max_time ( ) const

The current max_time_ms setting.

Returns: The current max time (in milliseconds).

See also: http://docs.mongodb.org/manual/reference/operator/meta/maxTimeMS

◆ max_time() [2/2]

find & mongocxx::options::find::max_time ( std::chrono::milliseconds max_time )

Sets the maximum amount of time for this operation to run (server-side) in milliseconds.

Parameters

max_time The max amount of time (in milliseconds).

See also: http://docs.mongodb.org/manual/reference/operator/meta/maxTimeMS

◆ modifiers() [1/2]

const stdx::optional< bsoncxx::document::view_or_value > & mongocxx::options::find::modifiers ( ) const

Gets the current query modifiers.

Returns: The current query modifiers.

◆ modifiers() [2/2]

find & mongocxx::options::find::modifiers ( bsoncxx::document::view_or_value modifiers )

Sets the meta-operators modifying the output or behavior of the query.

Parameters

modifiers The query modifiers.

See also: http://docs.mongodb.org/manual/reference/operator/query-modifier/

◆ no_cursor_timeout() [1/2]

const stdx::optional< bool > & mongocxx::options::find::no_cursor_timeout ( ) const

Gets the current no_cursor_timeout setting.

Returns: The current no_cursor_timeout setting.

See also: http://docs.mongodb.org/meta-driver/latest/legacy/mongodb-wire-protocol/#op-query

◆ no_cursor_timeout() [2/2]

find & mongocxx::options::find::no_cursor_timeout ( bool no_cursor_timeout )

Sets the cursor flag to prevent cursor from timing out server-side due to a period of inactivity.

Parameters

no_cursor_timeout When true prevents the cursor from timing out.

See also: http://docs.mongodb.org/meta-driver/latest/legacy/mongodb-wire-protocol/#op-query

◆ projection() [1/2]

const stdx::optional< bsoncxx::document::view_or_value > & mongocxx::options::find::projection ( ) const

Gets the current projection set on this query.

Returns: The current projection.

See also: http://docs.mongodb.org/manual/tutorial/project-fields-from-query-results/

◆ projection() [2/2]

find & mongocxx::options::find::projection ( bsoncxx::document::view_or_value projection )

Sets a projection which limits the returned fields for all matching documents.

Parameters

projection The projection document.

See also: http://docs.mongodb.org/manual/tutorial/project-fields-from-query-results/

◆ read_preference() [1/2]

const stdx::optional< class read_preference > & mongocxx::options::find::read_preference ( ) const

The current read_preference for this operation.

Returns: The current read_preference.

See also: http://docs.mongodb.org/manual/core/read-preference/

◆ read_preference() [2/2]

find & mongocxx::options::find::read_preference ( class read_preference rp )

Sets the read_preference for this operation.

Parameters

rp	The new read_preference.

See also: http://docs.mongodb.org/manual/core/read-preference/

◆ skip() [1/2]

const stdx::optional< std::int32_t > & mongocxx::options::find::skip ( ) const

Gets the current number of documents to skip.

Returns: The number of documents to skip.

See also: http://docs.mongodb.org/manual/reference/method/cursor.skip/

◆ skip() [2/2]

find & mongocxx::options::find::skip ( std::int32_t skip )

Sets the number of documents to skip before returning results.

Parameters

skip	The number of documents to skip.

See also: http://docs.mongodb.org/manual/reference/method/cursor.skip/

◆ sort() [1/2]

const stdx::optional< bsoncxx::document::view_or_value > & mongocxx::options::find::sort ( ) const

Gets the current sort ordering for this query.

Returns: The current sort ordering.

See also: http://docs.mongodb.org/manual/reference/method/cursor.sort/

◆ sort() [2/2]

find & mongocxx::options::find::sort ( bsoncxx::document::view_or_value ordering )

The order in which to return matching documents.

If $orderby also exists in the modifiers document, the sort field takes precedence over $orderby.

Parameters

ordering Document describing the order of the documents to be returned.

See also: http://docs.mongodb.org/manual/reference/method/cursor.sort/

The documentation for this class was generated from the following file:

src/mongocxx/options/find.hpp

Public Member Functions

Detailed Description

Member Function Documentation

◆ allow_partial_results() [1/2]

◆ allow_partial_results() [2/2]

◆ batch_size() [1/2]

◆ batch_size() [2/2]

◆ comment() [1/2]

◆ comment() [2/2]

◆ cursor_type() [1/2]

◆ cursor_type() [2/2]

◆ hint() [1/2]

◆ hint() [2/2]

◆ limit() [1/2]

◆ limit() [2/2]

◆ max_await_time() [1/2]

◆ max_await_time() [2/2]

◆ max_time() [1/2]

◆ max_time() [2/2]

◆ modifiers() [1/2]

◆ modifiers() [2/2]

◆ no_cursor_timeout() [1/2]

◆ no_cursor_timeout() [2/2]

◆ projection() [1/2]

◆ projection() [2/2]

◆ read_preference() [1/2]

◆ read_preference() [2/2]

◆ skip() [1/2]

◆ skip() [2/2]

◆ sort() [1/2]

◆ sort() [2/2]