$allElementsTrue (Verificar se Todos os Elementos São Verdadeiros)
Última atualização: 2026-10-09
$allElementsTrue (Verificar se Todos os Elementos São Verdadeiros)
$allElementsTrue retorna true apenas se todo elemento de um array for verdadeiro. Um array vazio retorna true, seguindo a convenção da quantificação universal. Usos típicos: verificar se todo item de um pedido está em estoque ou se um usuário marcou todas as opções obrigatórias. Aceita um único argumento de array, e os elementos seguem a veracidade do MongoDB: 0, string vazia, null e false são falsos, tudo o mais é verdadeiro. É o dual de $anyElementTrue.
| Categoria | Conjunto, Condição e Conversão |
|---|---|
| Versão do MongoDB | 1.0+ |
| Idioma do Exemplo | mongosh (Shell) |
📝 Sintaxe
{ $allElementsTrue: [ <array> ] }
⚙️ Parâmetros
| array | A matriz a verificar; os elementos são julgados por veracidade. |
|---|
Retorno:true quando todo elemento é verdadeiro; uma matriz vazia retorna true
▶ Exemplo
Execute os comandos abaixo no seu mongosh local (requer um mongod em execução):
// $allElementsTrue: verificar se todo item está em estoque
db.orders.aggregate([
{ $project: {
allInStock: { $allElementsTrue: ['$inStockFlags'] }
} }
])
Saída:
{ '_id': 1, 'allInStock': true }
{ '_id': 2, 'allInStock': false }
📌 Notas
- Um array vazio retorna true, de forma contra-intuitiva; combine com $size para detectar vazio
- Valores falsos são 0, '', null e false; todo o resto é verdadeiro
- Aceita apenas arrays; argumentos que não são array geram erro
🏷️ Tags Relacionados
💡 Casos Relacionados
Mais casos práticos em breve.
📚 Tutoriais Relacionados
❓ Perguntas Frequentes
QO que um array vazio retorna?
ARetorna true por quantificação universal; use $size para verificações de vazio.
QQuais valores são falsos?
A0, string vazia, null e false; qualquer outra coisa, incluindo a string '0', é verdadeira.
QPode verificar campos de arrays de objetos?
AExtraia o campo para um array de booleanos com $map primeiro e depois passe-o.