$pop

定義

$pop

$pop 演算子により、配列から最初または最後の要素を削除できます。配列の最初の要素を削除するには $pop に-1 の値を渡します。配列の最後の要素を削除するには 1 の値を渡します。

$pop 演算子の形式は次のとおりです。

{ $pop: { <field>: <-1 | 1>, ... } }

<field> を埋め込みドキュメントまたは配列で指定するには、ドット表記を使用します。

動作

MongoDB 5.0 以降、更新演算子では名前が文字列ベースのドキュメントフィールドを辞書順に処理します。数値名のフィールドは、数値順に処理されます。詳細については、「更新演算子の動作」を参照してください。

<field> が配列でない場合、$pop 操作に失敗します。

$pop 演算子が <field> 内の最後の項目を削除すると、<field> には空の配列が保持されます。

MongoDB 5.0 以降、$popなどの更新演算子を空のオペランド式（{ }）と併用しても、mongod でエラーが発生しなくなりました。空の更新を使用すると変更は一切されず、oplog エントリも作成されません（操作は実行されません）。

例

db.students.insertOne( { _id: 1, scores: [ 8, 9, 10 ] } )

db.students.updateOne( { _id: 1 }, { $pop: { scores: -1 } } )

{ _id: 1, scores: [ 9, 10 ] }

db.students.insertOne( { _id: 10, scores: [ 9, 10 ] } )

db.students.updateOne( { _id: 10 }, { $pop: { scores: 1 } } )

{ _id: 10, scores: [ 9 ] }