mongocxx::options::replace Class Reference

Class representing the optional arguments to a MongoDB replace operation. More...

#include <replace.hpp>

Public Member Functions
replace &	bypass_document_validation (bool bypass_document_validation)
	Sets the bypass_document_validation option. More...
const stdx::optional< bool > &	bypass_document_validation () const
	Gets the current value of the bypass_document_validation option. More...
replace &	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...
replace &	upsert (bool upsert)
	Sets the upsert option. More...
const stdx::optional< bool > &	upsert () const
	Gets the current value of the upsert option. More...
replace &	write_concern (class write_concern wc)
	Sets the write_concern for this operation. More...
const stdx::optional< class write_concern > &	write_concern () const
	The current write_concern for this operation. More...

Detailed Description

Class representing the optional arguments to a MongoDB replace operation.

Member Function Documentation

bypass_document_validation() [1/2]

replace& mongocxx::options::replace::bypass_document_validation

(

bool

bypass_document_validation

)

Sets the bypass_document_validation option.

If true, allows the write to opt-out of document level validation.

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.

bypass_document_validation() [2/2]

const stdx::optional<bool>& mongocxx::options::replace::bypass_document_validation

(

)

const

Gets the current value of the bypass_document_validation option.

Returns

The optional value of the bypass_document_validation option.

collation() [1/2]

replace& mongocxx::options::replace::collation

(

bsoncxx::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://docs.mongodb.com/master/reference/collation/

collation() [2/2]

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

(

)

const

Retrieves the current collation for this operation.

Returns

The current collation.

See also

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

upsert() [1/2]

replace& mongocxx::options::replace::upsert

(

bool

upsert

)

Sets the upsert option.

By default, if no document matches the filter, the replace operation does nothing. However, by specifying upsert as true, this operation either updates matching documents or inserts a new document using the replace specification if no matching document exists.

Parameters

upsert

If set to true, creates a new document when no document matches the query criteria. The server-side default is false, which does not insert a new document if a match is not found.

Returns

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

upsert() [2/2]

const stdx::optional<bool>& mongocxx::options::replace::upsert

(

)

const

Gets the current value of the upsert option.

Returns

The optional value of the upsert option.

write_concern() [1/2]

replace& mongocxx::options::replace::write_concern

(

class write_concern

wc

)

Sets the write_concern for this operation.

Parameters

wc	The new write_concern

Returns

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

See also

https://docs.mongodb.com/master/core/write-concern/

write_concern() [2/2]

const stdx::optional<class write_concern>& mongocxx::options::replace::write_concern

(

)

const

The current write_concern for this operation.

Returns

The current write_concern

See also

https://docs.mongodb.com/master/core/write-concern/

---

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

• src/mongocxx/options/replace.hpp