$mul

欠落しているフィールド

フィールドがドキュメントに存在しない場合、$mul はフィールドを作成し、乗数と同じ数値型の値を 0 に設定します。

アトミック

$mul は、1 つのドキュメント内のアトミック操作です。

混合型

混在数値型（32ビット整数、64ビット整数、Double、Decimal128）の値の乗算では、数値型の変換が発生する可能性があります。混合数値型の値の乗算では、次の型変換規則が適用されます。

フィールドの値を乗算する

products コレクションを次のように作成します。

db.products.insertOne(
   { "_id" : 1, "item" : "Hats", "price" : Decimal128("10.99"), "quantity" : 25 }
)

次の操作では、 db.collection.updateOne()によるドキュメントのアップデート。 $mul演算子は、 priceフィールドに1.25を乗算し、 quantityフィールドに2を乗算します。

db.products.updateOne(
   { _id: 1 },
   { $mul:
      {
         price: Decimal128( "1.25" ),
         quantity: 2
       }
   }
)

更新された文書の内容:

• price は元の値 10.99 に 1.25 を掛けた値です

• quantity は元の値 25 に 2 を掛けた値です

{ _id: 1, item: 'Hats', price: Decimal128("13.7375"), quantity: 50 }

存在しないフィールドへの $mul 演算子の適用

次のドキュメントを products コレクションに追加します。

db.products.insertOne( { _id: 2,  item: "Unknown" } )

次の操作で、db.collection.updateOne() はドキュメントにないフィールドに $mul 演算子を適用しようとします。

db.products.updateOne(
   { _id: 2 },
   { $mul: { price: Decimal128("100") } }
)

db.collection.updateOne() 操作は次を実行します。

• priceフィールドを挿入する

• Decimal128("0") を設定する

{ "_id" : 2, "item" : "Unknown", "price" : Long(0) }

price フィールドの型は乗数と同じ Decimal128 です。

混合数値型の乗算

次のドキュメントを products コレクションに追加します。

db.products.insertOne( { _id: 3,  item: "Scarf", price: Decimal128("10") } )

次の操作では、db.collection.updateOne() は $mul 演算子を使用して、price フィールドの Decimal128(10) の値に Int32(5) を乗算します。

db.products.updateOne(
   { _id: 3 },
   { $mul: { price: Int32(5) } }
)

この操作の結果、次のドキュメントが作成されます。

{ _id: 3, item: 'Scarf', price: Decimal128("50") }

price フィールドの値は Decimal128 型です。詳細については、乗算型変換規則を参照してください。