複合演算子

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

オプションで、オプション ビルダー メソッドをfind_one_and_delete()に連鎖させることで、 find_one_and_delete()メソッドの動作を変更できます。 これらのビルダー メソッドはFindOneAndDeleteOptions構造体フィールドを設定します。

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

次のコードは、 comment()メソッドをfind_one_and_delete()メソッドに連結してcommentフィールドを設定する方法を示しています。

let res = my_coll.find_one_and_delete(filter)
    .comment(bson!("hello"))
    .await?;

検索と削除の例

次の例では、 find_one_and_delete()メソッドを使用して、 ageフィールドの値が10以下の最初のドキュメントを検索して削除します。

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

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

検索と更新の動作を変更する

オプションで、オプション ビルダー メソッドをfind_one_and_update()に連鎖させることで、 find_one_and_update()メソッドの動作を変更できます。 これらのビルダー メソッドはFindOneAndUpdateOptions構造体フィールドを設定します。

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

次のコードは、 comment()メソッドをfind_one_and_update()メソッドに連結してcommentフィールドを設定する方法を示しています。

let res = my_coll.find_one_and_update(filter, update)
    .comment(bson!("hello"))
    .await?;

検索と更新の例

この例では、次のアクションを実行する方法を示しています。

• find_one_and_update()メソッドを呼び出す

• schoolの値が"Aurora High School"であるドキュメントに一致するクエリフィルターをfind_one_and_update()に渡す

• アップデート ドキュメントをfind_one_and_update()に渡します。これで、 schoolフィールドを"Durango High School"に設定し、 ageフィールドを1ずつ増加させます

• 更新後に一致したドキュメントを返すには、 return_document()メソッドをfind_one_and_update()にチェーンします

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

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

検索と置換の動作を変更する

オプションで、オプション ビルダー メソッドをfind_one_and_replace()に連鎖させることで、 find_one_and_replace()メソッドの動作を変更できます。 これらのビルダー メソッドはFindOneAndReplaceOptions構造体フィールドを設定します。

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

次のコードは、 comment()メソッドをfind_one_and_replace()メソッドに連結してcommentフィールドを設定する方法を示しています。

let res = my_coll.find_one_and_replace(filter, replacement)
    .comment(bson!("hello"))
    .await?;

検索と置換の例

この例では、次のアクションを実行します。

• find_one_and_replace()メソッドを呼び出します

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

• 新しい学生を説明する置換ドキュメントをfind_one_and_replace()に渡します

• 置換後にドキュメントを返すには、 return_document()メソッドをfind_one_and_replace()にチェーンします

• メソッドを出力の フィールドと フィールドにチェーンしますprojection()find_one_and_replace()``to project only the ``nameschool

let filter = doc! { "name": doc! { "$regex": "Johnson" } };
let replacement =
    doc! { "name": "Toby Fletcher", 
           "age": 14,
           "school": "Durango High School" };
let res = my_coll.find_one_and_replace(filter, replacement)
    .return_document(ReturnDocument::After)
    .projection(doc! { "name": 1, "school": 1, "_id": 0 })
    .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