mongocxx::v_noabi::options::find_one_and_update Class Reference

#include <mongocxx/v_noabi/mongocxx/options/find_one_and_update.hpp>

Description

Used by mongocxx::v_noabi::collection.

Public Member Functions
	find_one_and_update ()=default
	Default initialization.
	find_one_and_update (v1::find_one_and_update_options opts)
	Construct with the mongocxx::v1 equivalent.
bsoncxx::v_noabi::stdx::optional< bsoncxx::v_noabi::array::view_or_value > const &	array_filters () const
	Get array filters for this operation.
find_one_and_update &	array_filters (bsoncxx::v_noabi::array::view_or_value array_filters)
	Set array filters for this operation.
bsoncxx::v_noabi::stdx::optional< bool > const &	bypass_document_validation () const
	The current setting for bypassing document validation.
find_one_and_update &	bypass_document_validation (bool bypass_document_validation)
	Whether or not to bypass document validation for this operation.
bsoncxx::v_noabi::stdx::optional< bsoncxx::v_noabi::document::view_or_value > const &	collation () const
	Retrieves the current collation for this operation.
find_one_and_update &	collation (bsoncxx::v_noabi::document::view_or_value collation)
	Sets the collation for this operation.
bsoncxx::v_noabi::stdx::optional< bsoncxx::v_noabi::types::bson_value::view_or_value > const	comment () const
	Gets the current value of the comment option.
find_one_and_update &	comment (bsoncxx::v_noabi::types::bson_value::view_or_value comment)
	Set the value of the comment option.
bsoncxx::v_noabi::stdx::optional< v_noabi::hint > const &	hint () const
	Gets the current hint.
find_one_and_update &	hint (v_noabi::hint index_hint)
	Sets the index to use for this operation.
bsoncxx::v_noabi::stdx::optional< bsoncxx::v_noabi::document::view_or_value > const	let () const
	Gets the current value of the let option.
find_one_and_update &	let (bsoncxx::v_noabi::document::view_or_value let)
	Set the value of the let option.
bsoncxx::v_noabi::stdx::optional< std::chrono::milliseconds > const &	max_time () const
	The current max_time setting.
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.
	operator v1::find_one_and_update_options () const
	Convert to the mongocxx::v1 equivalent.
bsoncxx::v_noabi::stdx::optional< bsoncxx::v_noabi::document::view_or_value > const &	projection () const
	Gets the current projection for this operation.
find_one_and_update &	projection (bsoncxx::v_noabi::document::view_or_value projection)
	Sets a projection, which limits the fields to return.
bsoncxx::v_noabi::stdx::optional< v_noabi::options::return_document > const &	return_document () const
	Which version of the updated document to return.
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.
bsoncxx::v_noabi::stdx::optional< bsoncxx::v_noabi::document::view_or_value > const &	sort () const
	Gets the current sort ordering.
find_one_and_update &	sort (bsoncxx::v_noabi::document::view_or_value ordering)
	Sets the order by which to search the collection for a matching document.
bsoncxx::v_noabi::stdx::optional< bool > const &	upsert () const
	Gets the current upsert setting.
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.
bsoncxx::v_noabi::stdx::optional< v_noabi::write_concern > const &	write_concern () const
	Gets the current write concern.
find_one_and_update &	write_concern (v_noabi::write_concern write_concern)
	Sets the write concern for this operation.

Constructor & Destructor Documentation

find_one_and_update() [1/2]

mongocxx::v_noabi::options::find_one_and_update::find_one_and_update ( )

default

Default initialization.

find_one_and_update() [2/2]

mongocxx::v_noabi::options::find_one_and_update::find_one_and_update

(

v1::find_one_and_update_options

opts

)

Construct with the mongocxx::v1 equivalent.

Member Function Documentation

array_filters() [1/2]

bsoncxx::v_noabi::stdx::optional< bsoncxx::v_noabi::array::view_or_value > const & mongocxx::v_noabi::options::find_one_and_update::array_filters ( ) const

inline

Get array filters for this operation.

Returns

The current array filters.

See also

• https://www.mongodb.com/docs/manual/reference/command/findAndModify/

array_filters() [2/2]

find_one_and_update & mongocxx::v_noabi::options::find_one_and_update::array_filters ( bsoncxx::v_noabi::array::view_or_value array_filters )

inline

Set array filters for this operation.

Parameters

array_filters

Array representing filters determining which array elements to modify.

Returns

A reference to the object on which this member function is being called. This facilitates method chaining.

See also

• https://www.mongodb.com/docs/manual/reference/command/findAndModify/

bypass_document_validation() [1/2]

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

inline

The current setting for bypassing document validation.

Returns

the current bypass document validation setting.

See also

• https://www.mongodb.com/docs/manual/reference/command/findAndModify/

bypass_document_validation() [2/2]

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

inline

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.

Returns

A reference to the object on which this member function is being called. This facilitates method chaining.

See also

• https://www.mongodb.com/docs/manual/reference/command/findAndModify/

collation() [1/2]

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

inline

Retrieves the current collation for this operation.

Returns

The current collation.

See also

• https://www.mongodb.com/docs/manual/reference/command/findAndModify/

collation() [2/2]

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

inline

Sets the collation for this operation.

Parameters

collation

The new collation.

Returns

A reference to the object on which this member function is being called. This facilitates method chaining.

See also

• https://www.mongodb.com/docs/manual/reference/command/findAndModify/

comment() [1/2]

bsoncxx::v_noabi::stdx::optional< bsoncxx::v_noabi::types::bson_value::view_or_value > const mongocxx::v_noabi::options::find_one_and_update::comment ( ) const

inline

Gets the current value of the comment option.

Returns

The current comment option.

comment() [2/2]

find_one_and_update & mongocxx::v_noabi::options::find_one_and_update::comment ( bsoncxx::v_noabi::types::bson_value::view_or_value comment )

inline

Set the value of the comment option.

Parameters

comment

The new comment option.

Returns

A reference to the object on which this member function is being called. This facilitates method chaining.

hint() [1/2]

bsoncxx::v_noabi::stdx::optional< v_noabi::hint > const & mongocxx::v_noabi::options::find_one_and_update::hint ( ) const

inline

Gets the current hint.

Returns

The current hint, if one is set.

hint() [2/2]

find_one_and_update & mongocxx::v_noabi::options::find_one_and_update::hint ( v_noabi::hint index_hint )

inline

Sets the index to use for this operation.

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.

Returns

A reference to the object on which this member function is being called. This facilitates method chaining.

let() [1/2]

bsoncxx::v_noabi::stdx::optional< bsoncxx::v_noabi::document::view_or_value > const mongocxx::v_noabi::options::find_one_and_update::let ( ) const

inline

Gets the current value of the let option.

Returns

The current let option.

let() [2/2]

find_one_and_update & mongocxx::v_noabi::options::find_one_and_update::let ( bsoncxx::v_noabi::document::view_or_value let )

inline

Set the value of the let option.

Parameters

let	The new let option.

Returns

A reference to the object on which this member function is being called. This facilitates method chaining.

max_time() [1/2]

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

inline

The current max_time setting.

Returns

the current max allowed running time (in milliseconds).

See also

• https://www.mongodb.com/docs/manual/reference/command/findAndModify/

max_time() [2/2]

find_one_and_update & mongocxx::v_noabi::options::find_one_and_update::max_time ( std::chrono::milliseconds max_time )

inline

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).

Returns

A reference to the object on which this member function is being called. This facilitates method chaining.

See also

• https://www.mongodb.com/docs/manual/reference/command/findAndModify/

operator v1::find_one_and_update_options()

mongocxx::v_noabi::options::find_one_and_update::operator v1::find_one_and_update_options ( ) const

inlineexplicit

Convert to the mongocxx::v1 equivalent.

projection() [1/2]

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

inline

Gets the current projection for this operation.

Returns

The current projection.

See also

• https://www.mongodb.com/docs/manual/reference/command/findAndModify/

projection() [2/2]

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

inline

Sets a projection, which limits the fields to return.

Parameters

projection

The projection document.

Returns

A reference to the object on which this member function is being called. This facilitates method chaining.

See also

• https://www.mongodb.com/docs/manual/reference/command/findAndModify/

return_document() [1/2]

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

inline

Which version of the updated document to return.

Returns

Version of document to return, either original or updated.

See also

• https://www.mongodb.com/docs/manual/reference/command/findAndModify/
• mongocxx::v_noabi::options::return_document

return_document() [2/2]

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

inline

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.

Returns

A reference to the object on which this member function is being called. This facilitates method chaining.

See also

• https://www.mongodb.com/docs/manual/reference/command/findAndModify/
• mongocxx::v_noabi::options::return_document

sort() [1/2]

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

inline

Gets the current sort ordering.

Returns

The current sort ordering.

See also

• https://www.mongodb.com/docs/manual/reference/command/findAndModify/

sort() [2/2]

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

inline

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.

Returns

A reference to the object on which this member function is being called. This facilitates method chaining.

See also

• https://www.mongodb.com/docs/manual/reference/command/findAndModify/

upsert() [1/2]

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

inline

Gets the current upsert setting.

Returns

The current upsert setting.

See also

• https://www.mongodb.com/docs/manual/reference/command/findAndModify/

upsert() [2/2]

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

inline

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.

Returns

A reference to the object on which this member function is being called. This facilitates method chaining.

See also

• https://www.mongodb.com/docs/manual/reference/command/findAndModify/

write_concern() [1/2]

bsoncxx::v_noabi::stdx::optional< v_noabi::write_concern > const & mongocxx::v_noabi::options::find_one_and_update::write_concern ( ) const

inline

Gets the current write concern.

Returns

The current write concern.

See also

• https://www.mongodb.com/docs/manual/reference/command/findAndModify/

write_concern() [2/2]

find_one_and_update & mongocxx::v_noabi::options::find_one_and_update::write_concern ( v_noabi::write_concern write_concern )

inline

Sets the write concern for this operation.

Parameters

write_concern

Object representing the write concern.

Returns

A reference to the object on which this member function is being called. This facilitates method chaining.

See also

• https://www.mongodb.com/docs/manual/reference/command/findAndModify/

---

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

• mongocxx/v_noabi/mongocxx/options/find_one_and_update.hpp