Class representing a MongoDB update operation that modifies multiple documents. More...

#include <update_many.hpp>

Public Member Functions
	update_many (bsoncxx::document::view_or_value filter, bsoncxx::document::view_or_value update)
	Constructs an update operation that will modify all documents matching the filter.

const bsoncxx::document::view_or_value &	filter () const
	Gets the filter.

const bsoncxx::document::view_or_value &	update () const
	Gets the update document.

update_many &	upsert (bool upsert)
	Sets the upsert option.

const stdx::optional< bool > &	upsert () const
	Gets the current value of the upsert option.

Detailed Description

Class representing a MongoDB update operation that modifies multiple documents.

Constructor & Destructor Documentation

◆ update_many()

mongocxx::model::update_many::update_many	(	bsoncxx::document::view_or_value	filter,
		bsoncxx::document::view_or_value	update
	)

Constructs an update operation that will modify all documents matching the filter.

Parameters

filter	Document representing the criteria for applying the update.
update	Document representing the modifications to be applied to matching documents.

Member Function Documentation

◆ filter()

const bsoncxx::document::view_or_value & mongocxx::model::update_many::filter ( ) const

Gets the filter.

Returns: The filter to be used for the update operation.

◆ update()

const bsoncxx::document::view_or_value & mongocxx::model::update_many::update ( ) const

Gets the update document.

Returns: The modifications to be applied as part of the update.

◆ upsert() [1/2]

const stdx::optional< bool > & mongocxx::model::update_many::upsert ( ) const

Gets the current value of the upsert option.

Returns: The optional value of the upsert option.

◆ upsert() [2/2]

update_many & mongocxx::model::update_many::upsert ( bool upsert )

Sets the upsert option.

When upsert is false, update does nothing when no documents match the filter. However, by specifying upsert as true, this operation either updates matching documents or inserts a new document using the update specification if no matching document exists. By default, upsert is unset by the driver, and the server-side default, false, is used.