- Reference >
- Operators >
- Update Operators >
- Array Update Operators >
- $pullAll
$pullAll¶
On this page
Definition¶
- $pullAll¶
The $pullAll operator removes all instances of the specified values from an existing array. Unlike the $pull operator that removes elements by specifying a query, $pullAll removes elements that match the listed values.
The $pullAll operator has the form:
{ $pullAll: { <field1>: [ <value1>, <value2> ... ], ... } }
To specify a <field> in an embedded document or in an array, use dot notation.
Behavior¶
If a <value> to remove is a document or an array, $pullAll removes only the elements in the array that match the specified <value> exactly, including order.
Examples¶
Given the following document in the survey collection:
{ _id: 1, scores: [ 0, 2, 5, 5, 1, 0 ] }
The following operation removes all instances of the value 0 and 5 from the scores array:
db.survey.update( { _id: 1 }, { $pullAll: { scores: [ 0, 5 ] } } )
After the operation, the updated document has all instances of 0 and 5 removed from the scores field:
{ "_id" : 1, "scores" : [ 2, 1 ] }
Thank you for your feedback!
We're sorry! You can Report a Problem to help us improve this page.