Struct ReplaceOne 

pub struct ReplaceOne<'a> { /* private fields */ }

Replace up to one document matching a query. Construct with Collection::replace_one.

Implementations

impl<'a> ReplaceOne<'a>

pub fn session(self, value: impl Into<&'a mut ClientSession>) -> ReplaceOne<'a>

Use the provided session when running the operation.

pub fn with_options( self, value: impl Into<Option<ReplaceOptions>>, ) -> ReplaceOne<'a>

Set all options. Note that this will replace all previous values set.

pub fn bypass_document_validation(self, value: bool) -> ReplaceOne<'a>

Opt out of document-level validation.

pub fn upsert(self, value: bool) -> ReplaceOne<'a>

If true, insert a document if no matching document is found.

pub fn collation(self, value: Collation) -> ReplaceOne<'a>

The collation to use for the operation.

See the documentation for more information on how to use this option.

pub fn hint(self, value: Hint) -> ReplaceOne<'a>

A document or string that specifies the index to use to support the query predicate.

See the official MongoDB documentation for examples.

pub fn write_concern(self, value: WriteConcern) -> ReplaceOne<'a>

The write concern for the operation.

pub fn let_vars(self, value: Document) -> ReplaceOne<'a>

Map of parameter names and values. Values must be constant or closed expressions that do not reference document fields. Parameters can then be accessed as variables in an aggregate expression context (e.g. “$$var”).

Only available in MongoDB 5.0+.

pub fn comment(self, value: impl Into<Bson>) -> ReplaceOne<'a>

Tags the query with an arbitrary Bson value to help trace the operation through the database profiler, currentOp and logs.

This option is only available on server versions 4.4+.

pub fn sort(self, value: Document) -> ReplaceOne<'a>

Specify which document the operation replaces if the query matches multiple documents. The first document matched by the sort order will be replaced.

Only available in MongoDB 8.0+.

Trait Implementations

impl<'a> Action for ReplaceOne<'a>

fn optional<Value>( self, value: Option<Value>, f: impl FnOnce(Self, Value) -> Self, ) -> Self

where Self: Sized,

If the value is Some, call the provided function on self. Convenient for chained updates with values that need to be set conditionally. For example:

impl<'a> IntoFuture for ReplaceOne<'a>

type Output = Result<UpdateResult, Error>

The output that the future will produce on completion.

type IntoFuture = ReplaceOneFuture<'a>

Which kind of future are we turning this into?

fn into_future(self) -> <ReplaceOne<'a> as IntoFuture>::IntoFuture

Creates a future from a value.