$in（集計）

定義

$in

バージョン 3.4 で追加。

指定した値が配列内にあるかどうかをブール値で返します。

注意

このドキュメントでは、 $in集計演算子について説明します。 $inクエリ演算子については、 $in を参照してください。

$inには次の演算子式の構文があります。

{ $in: [ <expression>, <array expression> ] }

オペランド	説明
<expression>	任意の有効な式。
<array expression>	配列に変換される任意の有効な式。

$in クエリ演算子とは異なり、集計 $in 演算子は正規表現による一致をサポートしていません。

例	結果
{ $in: [ 2, [ 1, 2, 3 ] ] }	true
{ $in: [ "abc", [ "xyz", "abc" ] ] }	true
{ $in: [ "xy", [ "xyz", "abc" ] ] }	false
{ $in: [ [ "a" ], [ "a" ] ] }	false
{ $in: [ [ "a" ], [ [ "a" ] ] ] }	true
{ $in: [ /^a/, [ "a" ] ] }	false
{ $in: [ /^a/, [ /^a/ ] ] }	true

動作

$in $in 式に 2 つの引数が厳密に指定されていない場合、または 2 番目の引数が配列に変換されない場合は、エラーを出して失敗します。

例

fruit という名前のコレクションには次のドキュメントが含まれています。

{ "_id" : 1, "location" : "24th Street",
  "in_stock" : [ "apples", "oranges", "bananas" ] }
{ "_id" : 2, "location" : "36th Street",
  "in_stock" : [ "bananas", "pears", "grapes" ] }
{ "_id" : 3, "location" : "82nd Street",
  "in_stock" : [ "cantaloupes", "watermelons", "apples" ] }

次の集計操作では、各ドキュメントの in_stock 配列を調べて、文字列 bananas の有無を判断します。

db.fruit.aggregate([
  {
    $project: {
      "store location" : "$location",
      "has bananas" : {
        $in: [ "bananas", "$in_stock" ]
      }
    }
  }
])

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

{ "_id" : 1, "store location" : "24th Street", "has bananas" : true }
{ "_id" : 2, "store location" : "36th Street", "has bananas" : true }
{ "_id" : 3, "store location" : "82nd Street", "has bananas" : false }