MongoDB C++ Driver  mongocxx-3.0.0
Public Member Functions | List of all members
mongocxx::options::find_one_and_update Class Reference

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

#include <find_one_and_update.hpp>

Public Member Functions

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

void 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_validationWhether or not to bypass document validation.
See also
https://docs.mongodb.org/manual/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.
void 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_timeThe max amount of time (in milliseconds).
See also
http://docs.mongodb.org/manual/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
http://docs.mongodb.org/manual/reference/operator/meta/maxTimeMS
void mongocxx::options::find_one_and_update::projection ( bsoncxx::document::view_or_value  projection)

Sets a projection, which limits the fields to return.

Parameters
projectionThe projection document.
See also
http://docs.mongodb.org/manual/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
http://docs.mongodb.org/manual/tutorial/project-fields-from-query-results/
void 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_documentVersion of document to return, either original or updated.
See also
http://docs.mongodb.org/manual/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
http://docs.mongodb.org/manual/reference/command/findAndModify/
mongocxx::options::return_document
void 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
orderingDocument describing the order of the documents to be returned.
See also
http://docs.mongodb.org/manual/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
http://docs.mongodb.org/manual/reference/command/findAndModify/
void 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
upsertWhether or not to perform an upsert.
See also
http://docs.mongodb.org/manual/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
http://docs.mongodb.org/manual/reference/command/findAndModify/

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