复合运算符

修改查找和删除行为

您可以选择通过将FineOneAndDeleteOptions实例作为参数传递来修改find_one_and_delete()方法的行为。 要为每个设置使用默认值，请为 options 参数指定值None 。

下表描述了FineOneAndDeleteOptions中可用的选项：

Rust 驱动程序实现了用于创建FindOneAndDeleteOptions实例的 Builder 设计模式。 您可以使用该类型的builder()方法，通过逐个链接选项构建器函数来构造选项实例。

以下代码显示如何构造 FindOneAndDeleteOptions 实例，并将其传递给 find_one_and_delete() 方法：

let opts = FindOneAndDeleteOptions::builder().comment(bson!("hello")).build();
let res = my_coll.find_one_and_delete(filter, opts).await?;

查找和删除示例

以下示例使用find_one_and_delete()方法匹配并删除age字段的值小于或等于10的第一个文档：

let filter = doc! { "age": doc! { "$lte": 10 } };
let res = my_coll.find_one_and_delete(filter, None).await?;
println!("Deleted document:\n{:?}", res);

Deleted document:
Some(Document({"_id": ObjectId("..."),
"name": String("Deanna Porowski"), "age": Int32(10), "school":
String("Lakeside Elementary")}))

修改查找和更新行为

您可以选择通过将FindOneAndUpdateOptions实例作为参数传递来修改find_one_and_update()方法的行为。 要为每个设置使用默认值，请为 options 参数指定值None 。

下表描述了FineOneAndDeleteOptions中可用的选项：

Rust 驱动程序实现了用于创建FindOneAndUpdateOptions实例的 Builder 设计模式。 您可以使用该类型的builder()方法，通过逐个链接选项构建器方法来构造选项实例。

以下代码显示如何构造 FindOneAndUpdateOptions 实例，并将其传递给 find_one_and_update() 方法：

let opts = FindOneAndUpdateOptions::builder().comment(bson!("hello")).build();
let res = my_coll.find_one_and_update(filter, update, opts).await?;

查找和更新示例

此示例演示如何使用以下参数调用find_one_and_update()方法：

• 与school值为"Aurora High School"的文档匹配的查询筛选器

• 将school字段设置为"Durango High School"并将age字段递增1的更新文档

• 更新后返回文档的FindOneAndUpdateOptions实例

let filter = doc! { "school": "Aurora High School" };
let update =
    doc! { "$set": doc! { "school": "Durango High School" },
           "$inc": doc! { "age": 1 } };
let opts = FindOneAndUpdateOptions::builder()
    .return_document(Some(ReturnDocument::After))
    .build();
let res = my_coll.find_one_and_update(filter, update, opts).await?;
println!("Updated document:\n{:?}", res);

Updated document:
Some(Document({"_id": ObjectId("..."),
"name": String("Ben Joseph"), "age": Int32(17), "school":
String("Durango High School")}))

修改查找和替换行为

您可以选择通过将FindOneAndReplaceOptions实例作为参数传递来修改find_one_and_replace()方法的行为。 要为每个设置使用默认值，请为 options 参数指定值None 。

下表描述了FindOneAndReplaceOptions中可用的选项：

Rust 驱动程序实现了用于创建FindOneAndReplaceOptions实例的 Builder 设计模式。 您可以使用该类型的builder()方法，通过逐个链接选项构建器函数来构造选项实例。

以下代码显示如何构造 FindOneAndReplaceOptions 实例，并将其传递给 find_one_and_replace() 方法：

let opts = FindOneAndReplaceOptions::builder().comment(bson!("hello")).build();
let res = my_coll.find_one_and_replace(filter, replacement, opts).await?;

查找和替换示例

此示例演示如何使用以下参数调用find_one_and_replace()方法：

• 查询过滤器，用于匹配 name 的值包含字符串 "Johnson" 的文档

• 描述新学生的替换文档

• 一个实例FindOneAndReplaceOptions，它在替换后返回文档，并仅在输出中的项目name和school字段

let filter = doc! { "name": doc! { "$regex": "Johnson" } };
let replacement =
    doc! { "name": "Toby Fletcher", 
           "age": 14,
           "school": "Durango High School" };
let opts = FindOneAndReplaceOptions::builder()
    .return_document(Some(ReturnDocument::After))
    .projection(doc! { "name": 1, "school": 1, "_id": 0 })
    .build();
let res = my_coll.find_one_and_replace(filter, replacement, opts).await?;
println!("Document after replacement:\n{:?}", res);

Document after replacement:
Some(Document({"name": String("Toby Fletcher"), "school":
String("Durango High School")}))

API 文档

要进一步了解本指南所提及的方法和类型，请参阅以下 API 文档：

• find_one_and_delete()

• FindOneAndDeleteOptions

• find_one_and_update()

• FindOneAndUpdateOptions

• returnDocument

• find_one_and_replace()

• FindOneAndReplaceOptions