$concatArrays (agregação)

Definição

$concatArrays

Concatena arrays para retornar a array concatenada.

$concatArrays tem a seguinte sintaxe:

{ $concatArrays: [ <array1>, <array2>, ... ] }

As expressões do <array> podem ser qualquer expressão válida desde que atreladas a uma array. Para mais informações sobre expressões, consulte Operadores de Expressão.

Caso algum argumento seja resolvido com um valor null ou caso algum fragmento seja destinado a um campo ausente, $concatArrays retornará null.

Comportamento

{ $concatArrays: [
   [ "hello", " "], [ "world" ]
] }

[ "hello", " ", "world" ]

{ $concatArrays: [
   [ "hello", " "],
   [ [ "world" ], "again"]
] }

[ "hello", " ", [ "world" ], "again" ]

Exemplo

Crie uma coleção denominada warehouses com os seguintes documentos:

db.warehouses.insertMany( [
   { _id : 1, instock: [ "chocolate" ], ordered: [ "butter", "apples" ] },
   { _id : 2, instock: [ "apples", "pudding", "pie" ] },
   { _id : 3, instock: [ "pears", "pecans" ], ordered: [ "cherries" ] },
   { _id : 4, instock: [ "ice cream" ], ordered: [ ] }
] )

O exemplo a seguir concatena as arrays instock e ordered :

db.warehouses.aggregate( [
   { $project: { items: { $concatArrays: [ "$instock", "$ordered" ] } } }
] )

{ _id : 1, items : [ "chocolate", "butter", "apples" ] }
{ _id : 2, items : null }
{ _id : 3, items : [ "pears", "pecans", "cherries" ] }
{ _id : 4, items : [ "ice cream" ] }