複合演算子

検索と削除の動作を変更する

オプションで、 FineOneAndDeleteOptionsインスタンスをパラメータとして渡すことで、 find_one_and_delete()メソッドの動作を変更できます。 各設定でデフォルト値を使用するには、オプション パラメータに値Noneを指定します。

次の表では、 FineOneAndDeleteOptionsで利用できるオプションについて説明しています。

Rust ドライバーは、 FindOneAndDeleteOptionsインスタンスを作成するためのビルダ設計パターンを実装します。 タイプのbuilder()メソッドを使用して、オプション ビルダー関数を 1 つずつ連鎖させてオプション インスタンスを構築できます。

次のコードは、 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()メソッドの動作を変更できます。 各設定でデフォルト値を使用するには、オプション パラメータに値Noneを指定します。

次の表では、 FineOneAndDeleteOptionsで利用できるオプションについて説明しています。

Rust ドライバーは、 FindOneAndUpdateOptionsインスタンスを作成するためのビルダ設計パターンを実装します。 タイプのbuilder()メソッドを使用して、オプション ビルダー メソッドを 1 つずつ連鎖させてオプション インスタンスを構築できます。

次のコードは、 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()メソッドの動作を変更できます。 各設定でデフォルト値を使用するには、オプション パラメータに値Noneを指定します。

次の表では、 FindOneAndReplaceOptionsで利用できるオプションについて説明しています。

Rust ドライバーは、 FindOneAndReplaceOptionsインスタンスを作成するためのビルダ設計パターンを実装します。 タイプのbuilder()メソッドを使用して、オプション ビルダー関数を 1 つずつ連鎖させてオプション インスタンスを構築できます。

次のコードは、 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()メソッドを呼び出す方法を示しています。

• "Johnson" nameの値に string が含まれるドキュメントに一致するクエリフィルター

• 新しい学生を説明する置換ドキュメント

• FindOneAndReplaceOptionsname置換後にドキュメントを返し、出力の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