/ /

/ /

$position (operador de actualización)

Definición

$position

La $position El modificador especifica la ubicación en la matriz en la que se encuentra el El operador $push inserta elementos. Sin el modificador $position, el operador $push inserta elementos al final del arreglo. Consulta los modificadores $push para obtener más información.

Para usar el modificador $position, debe aparecer junto con el modificador $each.

{
  $push: {
    <field>: {
       $each: [ <value1>, <value2>, ... ],
       $position: <num>
    }
  }
}

<num> indica la posición en el arreglo, basada en un índice de arreglo base cero (posición):

Un número no negativo corresponde a la posición en el array, comenzando desde el principio. Si el valor de <num> es mayor o igual que la longitud del array, el modificador no $position $push tiene efecto y añade elementos al final del array.
Un número negativo corresponde a la posición en el arreglo, contando desde (pero sin incluir) el último elemento del arreglo. Por ejemplo, -1 indica la posición justo antes del último elemento en el arreglo. Si especificas varios elementos en el arreglo $each, el último elemento añadido ocupa la posición especificada desde el final. Si el valor absoluto de <num> es mayor o igual que la longitud del arreglo, el $push agrega elementos al principio del arreglo.

Comportamiento

A partir de MongoDB 5.0, los operadores de actualización procesan los campos de documentos con nombres basados en cadenas en orden lexicográfico. Los campos con nombres numéricos se procesan en orden numérico. Consulta Comportamiento del operador de actualización para obtener más información.

Ejemplos

Agregar elementos al inicio del arreglo

Crear la colección students:

db.students.insertOne( { "_id" : 1, "scores" : [ 100 ] } )

La siguiente operación actualiza el campo scores para agregar los elementos 50, 60 y 70 al inicio del arreglo:

db.students.updateOne(
   { _id: 1 },
   {
     $push: {
        scores: {
           $each: [ 50, 60, 70 ],
           $position: 0
        }
     }
   }
)

La operación resultó en el siguiente documento actualizado:

{ "_id" : 1, "scores" : [  50,  60,  70,  100 ] }

Añadir elementos a la mitad del arreglo

Agregue un documento a la colección students:

db.students.insertOne( { "_id" : 2, "scores" : [  50,  60,  70,  100 ] } )

La siguiente operación actualiza el campo scores para agregar los elementos 20 y 30 en el índice de arreglo (posición) 2:

db.students.updateOne(
   { _id: 2 },
   {
     $push: {
        scores: {
           $each: [ 20, 30 ],
           $position: 2
        }
     }
   }
)

La operación resultó en el siguiente documento actualizado:

{ "_id" : 2, "scores" : [  50,  60,  20,  30,  70,  100 ] }

Uso de un índice (posición) de arreglo negativo para añadir elementos al arreglo

$position puede aceptar un valor de índice de matriz (posición) negativo para indicar la posición desde el final, contando desde (pero sin incluir) el último elemento de la matriz. Por ejemplo, -1 indica la posición justo antes del último elemento de la matriz.

Añada el siguiente documento a la colección students:

db.students.insertOne(
   { "_id" : 3, "scores" : [  50,  60,  20,  30,  70,  100 ] }
)

La siguiente operación especifica -2 para $position a fin de añadir 90 en la posición dos lugares antes del último elemento, y después 80 en la posición dos lugares antes del último elemento.

Importante

Con un índice (posición) de arreglo negativo, si especificas varios elementos en el arreglo $each, el último elemento añadido está en la posición especificada contando desde el final.

db.students.updateOne(
   { _id: 3 },
   {
     $push: {
        scores: {
           $each: [ 90, 80 ],
           $position: -2
        }
     }
   }
)

La operación resultó en el siguiente documento actualizado:

{ "_id" : 3, "scores" : [ 50, 60, 20, 30, 90, 80, 70, 100 ] }

Volver

$each

$slice