$setEquals (集合の等価性を確認)

最終更新：2026-10-09

$setEquals (集合の等価性を確認)

$setEquals は、2 つ以上の配列が集合として等しいかを、順序と重複を無視して判定します。代表的な用途は、2 つの権限リストが一致するかの確認や、設定と既定値の比較です。複数の引数を受け付け、すべての配列が集合として等しいときだけ true を返します。null 要素は無視されるため、null を含む配列は null がないものとして比較されます。順序は関係ありません。[1, 2] と [2, 1] は等しいと判定されます。

📝 構文

{ $setEquals: [ <array1>, <array2>, ... ] }

⚙️ パラメータ

戻り値：すべての配列が集合として等しい場合は true、それ以外は false

▶ 例

以下のコマンドをローカルの mongosh で実行してください（mongod が起動済みである必要があります）：

// $setEquals: 2 つの権限リストが一致するか
db.roles.aggregate([
  { $project: {
      samePerms: { $setEquals: ['$userPerms', '$defaultPerms'] }
  } }
])

出力：

{ '_id': 1, 'samePerms': true }

📌 注意事項

• 順序と重複は無視される: [1, 2] と [2, 1, 1] は等しい
• 複数の引数に対応。true になるのはすべてが集合として等しいときだけ
• null 要素はあたかも存在しないかのように無視される

🏷️ 関連タグ

💡 関連ケース

📚 関連チュートリアル

❓ よくある質問

Web-Tutorial 技術チーム

複数の開発者によって共同維持されているプログラミングチュートリアルプラットフォーム。各チュートリアルは専門分野の開発者が執筆・レビューしています。正確で信頼性の高いコンテンツを目指しています — 問題を見つけた場合はお知らせください。

私たちについて