$reverseArray (agregación)

Esta versión de la documentación está archivada y ya no recibe soporte. Para actualizar su implementación 5.0, consulte Procedimientos de actualización de MongoDB.6.0

Definición

$reverseArray

Nuevo en la versión 3.4.

Acepta una expresión de matriz como argumento y devuelve una matriz con los elementos en orden inverso.

$reverseArray tiene lo siguiente Sintaxis de expresión del operador:

{ $reverseArray: <array expression> }

El argumento puede ser cualquier expresión válida siempre que se resuelva en una matriz.

Comportamiento

Si el argumento se resuelve en un valor de null o hace referencia a un campo faltante, $reverseArray nulldevuelve.

Si el argumento no se resuelve en una matriz o null ni hace referencia a un campo faltante, devuelve un$reverseArray error.

$reverseArray devuelve una matriz vacía cuando el argumento es una matriz vacía.

Si el argumento contiene submatrices, $reverseArray solo opera en los elementos de la matriz de nivel superior y no revertirá el contenido de las submatrices.

Ejemplo []1

Resultados

{ $reverseArray: { $literal: [ 1, 2, 3 ] } }

[ 3, 2, 1 ]

{ $reverseArray:
   { $slice:  [ [ "foo", "bar", "baz", "qux" ], 1, 2 ] } }
}

[ "baz", "bar" ]

{ $reverseArray: null }

null

{ $reverseArray: { $literal: [ ] } }

[ ]

{ $reverseArray: { $literal: [ [ 1, 2, 3 ], [ 4, 5, 6 ] ] } }

[ [ 4, 5, 6 ], [ 1, 2, 3 ] ]

[1] Los ejemplos de la tabla toman un argumento literal. Para evitar ambigüedades de análisis si el argumento literal es una matriz, debe encapsular la matriz literal en una expresión o conservar la matriz externa que designa la lista de argumentos (p.$literal ej.,)[ [ 1, 2, 3 ] ] para pasar la matriz [1, 2, 3] literal.

Ejemplo

Una colección llamada users contiene los siguientes documentos:

{ "_id" : 1, "name" : "dave123", "favorites" : [ "chocolate", "cake", "butter", "apples" ] }
{ "_id" : 2, "name" : "li", "favorites" : [ "apples", "pudding", "pie" ] }
{ "_id" : 3, "name" : "ahn", "favorites" : [ ] }
{ "_id" : 4, "name" : "ty" }

El siguiente ejemplo devuelve un arreglo que contiene los elementos del arreglo favorites en orden inverso:

db.users.aggregate([
   {
     $project:
      {
         name: 1,
         reverseFavorites: { $reverseArray: "$favorites" }
      }
   }
])

La operación devuelve los siguientes resultados:

{ "_id" : 1, "name" : "dave123", "reverseFavorites" : [ "apples", "butter", "cake", "chocolate" ] }
{ "_id" : 2, "name" : "li", "reverseFavorites" : [ "pie", "pudding", "apples" ] }
{ "_id" : 3, "name" : "ahn", "reverseFavorites" : [ ] }
{ "_id" : 4, "name" : "ty", "reverseFavorites" : null }

Volver

$replaceAll

$round