Class representing the optional arguments to a MongoDB find_and_modify update operation. More...

#include <find_one_and_update.hpp>

Public Member Functions
find_one_and_update &	collation (bsoncxx::document::view_or_value collation)
	Sets the collation for this operation. More...

const stdx::optional< bsoncxx::document::view_or_value > &	collation () const
	Retrieves the current collation for this operation. More...

find_one_and_update &	bypass_document_validation (bool bypass_document_validation)
	Whether or not to bypass document validation for this operation. More...

const stdx::optional< bool > &	bypass_document_validation () const
	The current setting for bypassing document validation. More...

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

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

find_one_and_update &	projection (bsoncxx::document::view_or_value projection)
	Sets a projection, which limits the fields to return. More...

const stdx::optional< bsoncxx::document::view_or_value > &	projection () const
	Gets the current projection for this operation. More...

find_one_and_update &	return_document (return_document return_document)
	Set the desired version of the updated document to return, either the original document, or the updated. More...

const stdx::optional< mongocxx::options::return_document > &	return_document () const
	Which version of the updated document to return. More...

find_one_and_update &	sort (bsoncxx::document::view_or_value ordering)
	Sets the order by which to search the collection for a matching document. More...

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

find_one_and_update &	upsert (bool upsert)
	Sets the upsert flag on the operation. More...

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

Detailed Description

Class representing the optional arguments to a MongoDB find_and_modify update operation.

Member Function Documentation

find_one_and_update& mongocxx::options::find_one_and_update::bypass_document_validation ( bool bypass_document_validation )

Whether or not to bypass document validation for this operation.

Note: On servers >= 3.2, the server applies validation by default. On servers < 3.2, this option is ignored.

Parameters

bypass_document_validation Whether or not to bypass document validation.

See also: https://docs.mongodb.com/master/core/document-validation/#bypass-document-validation

const stdx::optional<bool>& mongocxx::options::find_one_and_update::bypass_document_validation ( ) const

The current setting for bypassing document validation.

Returns: the current bypass document validation setting.

find_one_and_update& mongocxx::options::find_one_and_update::collation ( bsoncxx::document::view_or_value collation )

Sets the collation for this operation.

Parameters

collation The new collation.

See also: https://docs.mongodb.com/master/reference/collation/

const stdx::optional<bsoncxx::document::view_or_value>& mongocxx::options::find_one_and_update::collation ( ) const

Retrieves the current collation for this operation.

Returns: The current collation.

See also: https://docs.mongodb.com/master/reference/collation/

find_one_and_update& mongocxx::options::find_one_and_update::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: https://docs.mongodb.com/master/reference/operator/meta/maxTimeMS

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

The current max_time setting.

Returns: the current max allowed running time (in milliseconds).

See also: https://docs.mongodb.com/master/reference/operator/meta/maxTimeMS

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

Sets a projection, which limits the fields to return.

Parameters

projection The projection document.

See also: https://docs.mongodb.com/master/tutorial/project-fields-from-query-results/

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

Gets the current projection for this operation.

Returns: The current projection.

See also: https://docs.mongodb.com/master/tutorial/project-fields-from-query-results/

find_one_and_update& mongocxx::options::find_one_and_update::return_document ( return_document return_document )

Set the desired version of the updated document to return, either the original document, or the updated.

By default, the original document is returned.

Parameters

return_document Version of document to return, either original or updated.

See also: https://docs.mongodb.com/master/reference/command/findAndModify/; mongocxx::options::return_document

const stdx::optional<mongocxx::options::return_document>& mongocxx::options::find_one_and_update::return_document ( ) const

Which version of the updated document to return.

Returns: Version of document to return, either original or updated.

See also: https://docs.mongodb.com/master/reference/command/findAndModify/; mongocxx::options::return_document

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

Sets the order by which to search the collection for a matching document.

Warning: This can influence which document the operation modifies if the provided filter selects multiple documents.

Parameters

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

See also: https://docs.mongodb.com/master/reference/command/findAndModify/

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

Gets the current sort ordering.

Returns: The current sort ordering.

See also: https://docs.mongodb.com/master/reference/command/findAndModify/

find_one_and_update& mongocxx::options::find_one_and_update::upsert ( bool upsert )

Sets the upsert flag on the operation.

When true, the operation creates a new document if no document matches the filter. When false, this operation will do nothing if there are no matching documents. The server-side default is false.

Parameters

upsert Whether or not to perform an upsert.

See also: https://docs.mongodb.com/master/reference/command/findAndModify/

const stdx::optional<bool>& mongocxx::options::find_one_and_update::upsert ( ) const

Gets the current upsert setting.

Returns: The current upsert setting.

See also: https://docs.mongodb.com/master/reference/command/findAndModify/

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

src/mongocxx/options/find_one_and_update.hpp

Public Member Functions

Detailed Description

Member Function Documentation