Menu Docs

Página inicial do Docs → Desenvolver aplicações → Manual do MongoDB

$isArray (agregação)

Nesta página

  • Definição
  • Comportamento
  • Exemplo

Definição

$isArray

Determina se o operando é um array. Retorna um booleano.

$isArray tem a seguinte sintaxe:

{ $isArray: [ <expression> ] }

Comportamento

O <expression> pode ser qualquer expressão válida. Para mais informações sobre expressões, consulte Operadores de Expressão.

Exemplo
Resultados
Notas
{ $isArray: "hello" }
false
"hello" é uma string, passada como uma string.
{ $isArray: [ "hello" ] }
false
"hello" é uma string, passada como parte de uma array de argumentos.
{ $isArray: [ [ "hello" ] ] }
true
[ "hello" ] é um array, passado como parte de um array de argumentos.

Observação

Expressões de aggregation aceitam um número variável de argumentos. Esses argumentos são normalmente passados como uma array. No entanto, quando o argumento é um único valor, você pode simplificar seu código passando o argumento diretamente sem envolvê-lo em uma array.

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: [ ] }
] )

Verifique se os campos instock e ordered são arrays. Se ambos os campos forem arrays, concatene-os:

db.warehouses.aggregate( [
   { $project:
      { items:
          { $cond:
            {
              if: { $and: [ { $isArray: "$instock" },
                            { $isArray: "$ordered" }
                          ] },
              then: { $concatArrays: [ "$instock", "$ordered" ] },
              else: "One or more fields is not an array."
            }
          }
      }
   }
] )
{ _id : 1, items : [ "chocolate", "butter", "apples" ] }
{ _id : 2, items : "One or more fields is not an array." }
{ _id : 3, items : [ "pears", "pecans", "cherries" ] }
{ _id : 4, items : [ "ice cream" ] }

Dica

Veja também:

← $integral (agregação)
$isNumber (agregação) →

Nesta página