$pullAll

$pullAll

Definition

$pullAll
The $pullAll operator removes all instances of thespecified values from an existing array. Unlike the $pulloperator 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, usedot notation.

Behavior

If a <value> to remove is a document or an array,$pullAll removes only the elements in the array that matchthe 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 and5 from the scores array:

db.survey.update( { _id: 1 }, { $pullAll: { scores: [ 0, 5 ] } } )

After the operation, the updated document has all instances of 0and 5 removed from the scores field:

{ "_id" : 1, "scores" : [ 2, 1 ] }