Menu Docs

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

$e (agregação)

Nesta página

  • Definição
  • Comportamento
  • Tratamento de erros
  • Exemplo

Definição

$and

Avalia uma ou mais expressões e retorna true se todas as expressões forem true ou se forem executadas sem expressões de argumento. Caso contrário, $and retornará false.

$and sintaxe:

{ $and: [ <expression1>, <expression2>, ... ] }

Para mais informações sobre expressões, consulte Expressões.

Comportamento

Além do valor booleano false , $and avalia como false os seguintes valores: null, 0 e undefined valores. O $and avalia todos os outros valores como true, inclusive valores numéricos diferentes de zero e arrays.

Exemplo
Resultado
{ $and: [ 1, "green" ] }
true
{ $and: [ ] }
true
{ $and: [ [ null ], [ false ], [ 0 ] ] }
true
{ $and: [ null, true ] }
false
{ $and: [ 0, true ] }
false

Tratamento de erros

Para permitir que o mecanismo de consulta otimize as consultas, o $and lida com erros como segue:

  • Se qualquer expressão fornecida para $and causar um erro quando avaliada sozinha, o $and contendo a expressão pode causar um erro, mas um erro não é garantido.

  • Uma expressão fornecida após a primeira expressão fornecida para $and pode causar um erro mesmo se a primeira expressão avaliar para false.

Por exemplo, a seguinte consulta sempre produz um erro se $x for 0:

db.example.find( {
   $expr: { $eq: [ { $divide: [ 1, "$x" ] }, 3 ] }
} )

A consulta a seguir, que contém várias expressões fornecidas para $and, pode gerar um erro se houver algum documento em que $x seja 0:

db.example.find( {
   $and: [
      { x: { $ne: 0 } },
      { $expr: { $eq: [ { $divide: [ 1, "$x" ] }, 3 ] } }
   ]
} )

Exemplo

Crie uma coleção de exemplo inventory com estes documentos:

db.inventory.insertMany([
   { "_id" : 1, "item" : "abc1", description: "product 1", qty: 300 },
   { "_id" : 2, "item" : "abc2", description: "product 2", qty: 200 },
   { "_id" : 3, "item" : "xyz1", description: "product 3", qty: 250 },
   { "_id" : 4, "item" : "VWZ1", description: "product 4", qty: 300 },
   { "_id" : 5, "item" : "VWZ2", description: "product 5", qty: 180 }
])

Esta operação utiliza o operador $and para determinar se qty é maior que 100 e menor que 250:

db.inventory.aggregate(
   [
     {
       $project:
          {
            item: 1,
            qty: 1,
            result: { $and: [ { $gt: [ "$qty", 100 ] }, { $lt: [ "$qty", 250 ] } ] }
          }
     }
   ]
)

A operação retorna estes resultados:

{ "_id" : 1, "item" : "abc1", "qty" : 300, "result" : false }
{ "_id" : 2, "item" : "abc2", "qty" : 200, "result" : true }
{ "_id" : 3, "item" : "xyz1", "qty" : 250, "result" : false }
{ "_id" : 4, "item" : "VWZ1", "qty" : 300, "result" : false }
{ "_id" : 5, "item" : "VWZ2", "qty" : 180, "result" : true }
← $allElementsTrue (agregação)
$anyElementTrue (agregação) →

Nesta página