$anyElementTrue (Verificar se Algum Elemento É Verdadeiro)
Última atualização: 2026-10-09
$anyElementTrue (Verificar se Algum Elemento É Verdadeiro)
$anyElementTrue retorna true quando ao menos um elemento de um array é verdadeiro. Um array vazio retorna false. Usos típicos: verificar se um usuário tem algum endereço de entrega ou se um pedido tem algum desconto ativo. É o dual de $allElementsTrue — true se algum elemento for verdadeiro. A veracidade segue as mesmas regras (0, string vazia, null e false são falsos).
| Categoria | Conjunto, Condição e Conversão |
|---|---|
| Versão do MongoDB | 1.0+ |
| Idioma do Exemplo | mongosh (Shell) |
📝 Sintaxe
{ $anyElementTrue: [ <array> ] }
⚙️ Parâmetros
| array | A matriz a verificar. |
|---|
Retorno:true quando qualquer elemento é verdadeiro; uma matriz vazia retorna false
▶ Exemplo
Execute os comandos abaixo no seu mongosh local (requer um mongod em execução):
// $anyElementTrue: alguma flag VIP está ativa
db.users.aggregate([
{ $project: {
isVip: { $anyElementTrue: ['$vipFlags'] }
} }
])
Saída:
{ '_id': 1, 'isVip': true }
{ '_id': 2, 'isVip': false }
📌 Notas
- Um array vazio retorna false
- Combine com $allElementsTrue para lógica completa de todos/qualquer
- Valores falsos são 0, '', null e false
🏷️ Tags Relacionados
💡 Casos Relacionados
Mais casos práticos em breve.
📚 Tutoriais Relacionados
❓ Perguntas Frequentes
QO que um array vazio retorna?
ARetorna false, o oposto de $allElementsTrue.
QComo se relaciona com $allElementsTrue?
AEles são duais: um é true se algum elemento for verdadeiro, o outro apenas se todos forem.
QPosso passar um array de campos booleanos?
ASim para arrays de booleanos; mapeie o campo primeiro para arrays de objetos.