$pow（集計）

定義

$pow

指定した指数まで数値を上げ、結果を返します。 $powの構文は次のとおりです。

{ $pow: [ <number>, <exponent> ] }

<number>式は、数値に変換される限り、有効な式であれば何でも使用できます。

<exponent>式は、数値に変換される限り、どのような有効な式でもかまいません。

0を負の指数に上げることはできません。

動作

結果は、その型で正確に表現できない場合を除き、入力と同じ型になります。この場合、以下のとおり動作します。

• 結果が 64 ビット整数として表現可能な場合は、32 ビット整数は 64 ビット整数に変換されます。

• 結果が 64 ビット整数として表現不可能な場合は、32 ビット整数は double に変換されます。

• 結果が 64 ビット整数として表現不可能な場合は、64 ビット整数は double に変換されます。

引数がnullの値に解決されるか、欠落しているフィールドを参照する場合、 $powはnullを返します。 いずれかの引数がNaNに解決された場合、 $powはNaNを返します。

例

次のドキュメントを含むquizzesというコレクションを作成します。

db.quizzes.insertMany( [
   {
      _id : 1,
      scores : [
         { name : "dave123", score : 85 },
         { name : "dave2", score : 90 },
         { name : "ahn", score : 71 }
      ]
   },
   {
      _id : 2,
      scores : [
         { name : "li", quiz : 2, score : 96 },
         { name : "annT", score : 77 },
         { name : "ty", score : 82 }
      ]
   }
] )

次の例では、各クイズの分散を計算します。

db.quizzes.aggregate( [
   { $project: { variance: { $pow: [ { $stdDevPop: "$scores.score" }, 2 ] } } }
] )

この操作は次の結果を返します。

{ _id : 1, variance : 64.66666666666667 }
{ _id : 2, variance : 64.66666666666667 }