$pop (operador de atualizar)

Definição

$pop

The $pop operator removes the first or last element of an array. Pass $pop a value of -1 to remove the first element of an array and 1 to remove the last element in an array.

The $pop operator has the form:

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

Para especificar um <field> em um documento incorporado ou em uma array, use a notação de ponto.

Comportamento

A partir do MongoDB 5.0, os operadores de atualização processam campos de documento com nomes baseados em cadeia de caracteres em ordem lexicográfica. Os campos com nomes numéricos são processados em ordem numérica. Consulte Atualizar Comportamento de Operadores para detalhes.

The $pop operation fails if the <field> is not an array.

If the $pop operator removes the last item in the <field>, the <field> will then hold an empty array.

Starting in MongoDB 5.0, mongod no longer raises an error when you use an update operator like $pop with an empty operand expression ( { } ). An empty update results in no changes and no oplog entry is created (meaning that the operation is a no-op).

Exemplos

Remover o primeiro item de uma array

Crie a coleção students:

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

O exemplo seguinte remove o primeiro elemento, 8, da array scores:

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

O primeiro elemento, 8, foi removido da array scores:

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

Remover o último item de uma array

Adicione o seguinte documento à coleção students:

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

The following example removes the last element, 10, from the scores array by specifying 1 in the $pop expression:

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

O último elemento, 10, foi removido da array scores:

{ _id: 10, scores: [ 9 ] }

Dica

Voltar

$addToSet

$pull