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

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

Description

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

Public Member Functions
const stdx::optional< bsoncxx::v_noabi::array::view_or_value > &	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.
const stdx::optional< bool > &	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.
const stdx::optional< bsoncxx::v_noabi::document::view_or_value > &	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.
const stdx::optional< bsoncxx::v_noabi::types::bson_value::view_or_value >	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.
const stdx::optional< mongocxx::v_noabi::hint > &	hint () const
	Gets the current hint.
find_one_and_update &	hint (mongocxx::v_noabi::hint index_hint)
	Sets the index to use for this operation.
const stdx::optional< bsoncxx::v_noabi::document::view_or_value >	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.
const stdx::optional< std::chrono::milliseconds > &	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.
const stdx::optional< bsoncxx::v_noabi::document::view_or_value > &	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.
const stdx::optional< mongocxx::v_noabi::options::return_document > &	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.
const stdx::optional< bsoncxx::v_noabi::document::view_or_value > &	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.
const stdx::optional< bool > &	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.
const stdx::optional< mongocxx::v_noabi::write_concern > &	write_concern () const
	Gets the current write concern.
find_one_and_update &	write_concern (mongocxx::v_noabi::write_concern write_concern)
	Sets the write concern for this operation.

Member Function Documentation

array_filters() [1/2]

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

(

)

const

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

)

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]

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

(

)

const

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

)

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]

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

(

)

const

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

)

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]

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

(

)

const

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

)

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]

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

(

)

const

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

(

mongocxx::v_noabi::hint

index_hint

)

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]

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

(

)

const

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

)

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]

const stdx::optional< std::chrono::milliseconds > & mongocxx::v_noabi::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://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

)

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/

projection() [1/2]

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

(

)

const

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

)

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]

const stdx::optional< mongocxx::v_noabi::options::return_document > & mongocxx::v_noabi::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://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

)

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]

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

(

)

const

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

)

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]

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

(

)

const

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

)

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]

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

(

)

const

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

(

mongocxx::v_noabi::write_concern

write_concern

)

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