MongoDB $reverseArray

No MongoDB, o $reverseArray operador de pipeline de agregação inverte a ordem dos itens em uma matriz.

Ele aceita uma expressão de array como argumento e retorna um array com os elementos na ordem inversa.

Exemplo

Suponha que tenhamos uma coleção chamada products com os seguintes documentos:

{ "_id" : 1, "prod" : "Bat", "sizes" : [ "S", "M", "L" ] }
{ "_id" : 2, "prod" : "Hat", "sizes" : [ "XS", "S", "L", "XL" ] }
{ "_id" : 3, "prod" : "Cap", "sizes" : [ "M", "L" ] }

Podemos usar o $reverseArray operador para inverter a ordem desses elementos da matriz.

Exemplo:

db.products.aggregate(
   [
     { $match: { _id: { $in: [ 1, 2, 3 ] } } },
     {
       $project:
          {
            _id: 0,
            sizes: 1,
            reversed: { $reverseArray: [ "$sizes" ] }
          }
     }
   ]
)

Resultado:

{ "sizes" : [ "S", "M", "L" ], "reversed" : [ "L", "M", "S" ] }
{ "sizes" : [ "XS", "S", "L", "XL" ], "reversed" : [ "XL", "L", "S", "XS" ] }
{ "sizes" : [ "M", "L" ], "reversed" : [ "L", "M" ] }

Matrizes vazias

Passar um array vazio retorna um array vazio.

Documento de exemplo:

{ "_id" : 4, "prod" : "Zap", "sizes" : [ ] }

Aplicar $reverseArray :

db.products.aggregate(
   [
     { $match: { _id: { $in: [ 4 ] } } },
     {
       $project:
          {
            _id: 0,
            sizes: 1,
            reversed: { $reverseArray: [ "$sizes" ] }
          }
     }
   ]
)

Resultado:

{ "sizes" : [ ], "reversed" : [ ] }

Valores nulos

Passando um valor de null retorna null .

Documento de exemplo:

{ "_id" : 5, "prod" : "Tap", "sizes" : null }

Aplicar $reverseArray :

db.products.aggregate(
   [
     { $match: { _id: { $in: [ 5 ] } } },
     {
       $project:
          {
            _id: 0,
            sizes: 1,
            reversed: { $reverseArray: [ "$sizes" ] }
          }
     }
   ]
)

Resultado:

{ "sizes" : null, "reversed" : null }

Campos ausentes

Aplicando $reverseArray para um campo que não existe no documento resulta em null sendo devolvido.

Documento de exemplo:

{ "_id" : 6, "prod" : "Map" }

Aplicar $reverseArray :

db.products.aggregate(
   [
     { $match: { _id: { $in: [ 6 ] } } },
     {
       $project:
          {
            _id: 0,
            sizes: 1,
            reversed: { $reverseArray: [ "$sizes" ] }
          }
     }
   ]
)

Resultado:

{ "reversed" : null }

Tipo de dados incorreto

Aplicando $reverseArray para um campo que não resolve para uma matriz resulta em um erro.

Documento de exemplo:

{ "_id" : 7, "prod" : "Box", "sizes" : "XXL" }

Aplicar $reverseArray :

db.products.aggregate(
   [
     { $match: { _id: { $in: [ 7 ] } } },
     {
       $project:
          {
            _id: 0,
            sizes: 1,
            reversed: { $reverseArray: [ "$sizes" ] }
          }
     }
   ]
)

Resultado:

uncaught exception: Error: command failed: {
	"ok" : 0,
	"errmsg" : "The argument to $reverseArray must be an array, but was of type: string",
	"code" : 34435,
	"codeName" : "Location34435"
} : aggregate failed :
[email protected]/mongo/shell/utils.js:25:13
[email protected]/mongo/shell/assert.js:18:14
[email protected]/mongo/shell/assert.js:639:17
[email protected]/mongo/shell/assert.js:729:16
[email protected]/mongo/shell/db.js:266:5
[email protected]/mongo/shell/collection.js:1058:12
@(shell):1:1