Struct mongodb::options::ReplaceOptions

#[non_exhaustive]
pub struct ReplaceOptions {
    pub bypass_document_validation: Option<bool>,
    pub upsert: Option<bool>,
    pub collation: Option<Collation>,
    pub hint: Option<Hint>,
    pub write_concern: Option<WriteConcern>,
    pub let_vars: Option<Document>,
    pub comment: Option<Bson>,
}

Specifies the options to a Collection::replace_one operation.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

bypass_document_validation: Option<bool>

Opt out of document-level validation.

upsert: Option<bool>

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

collation: Option<Collation>

The collation to use for the operation.

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

hint: Option<Hint>

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

Only available in MongoDB 4.2+. See the official MongoDB documentation for examples.

write_concern: Option<WriteConcern>

The write concern for the operation.

let_vars: Option<Document>

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

comment: Option<Bson>

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

Implementations

impl ReplaceOptions

pub fn builder() -> ReplaceOptionsBuilder<((), (), (), (), (), (), ())>

Create a builder for building ReplaceOptions. On the builder, call .bypass_document_validation(...)(optional), .upsert(...)(optional), .collation(...)(optional), .hint(...)(optional), .write_concern(...)(optional), .let_vars(...)(optional), .comment(...)(optional) to set the values of the fields. Finally, call .build() to create the instance of ReplaceOptions.

Trait Implementations

impl Clone for ReplaceOptions

fn clone(&self) -> ReplaceOptions

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ReplaceOptions

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ReplaceOptions

fn default() -> ReplaceOptions

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ReplaceOptions

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.