$ne (Diferente de)
Última atualização: 2026-10-09
$ne (Diferente de)
$ne é a comparação de desigualdade em forma de expressão. Ela recebe dois argumentos e retorna true quando eles diferem. É usado para excluir valores específicos ou encontrar registros diferentes, como pedidos cujo status não é fechado. A sintaxe de expressão { $ne: [expr1, expr2] } difere do operador de consulta. Observe que null comparado com null retorna false (igual), e em expressões um campo ausente participa como null — distinto do comportamento de consulta, em que $ne também corresponde a documentos sem o campo.
| Categoria | Conjunto, Condição e Conversão |
|---|---|
| Versão do MongoDB | 1.0+ |
| Idioma do Exemplo | mongosh (Shell) |
📝 Sintaxe
{ $ne: [ <expressão1>, <expressão2> ] }⚙️ Parâmetros
| expressão 1 | A primeira expressão a comparar. |
|---|---|
| expressão 2 | A segunda expressão a comparar. |
Retorno：true quando os valores diferem, false quando iguais
▶ Exemplo
Execute os comandos abaixo no seu mongosh local (requer um mongod em execução):
// $ne: encontrar pedidos cujo status não é fechado
db.orders.aggregate([
{ $project: {
active: { $ne: ['$status', 'closed'] }
} }
])Saída：
{ '_id': 1, 'active': true }
{ '_id': 2, 'active': false }📌 Notas
- null comparado com null retorna false
- Em expressões, um campo ausente participa como null
- É o inverso de $eq
🏷️ Tags Relacionados
💡 Casos Relacionados
Mais casos práticos em breve.
📚 Tutoriais Relacionados
❓ Perguntas Frequentes
QComo $ne e $eq se relacionam?
AEles são inversos; $ne é a negação de $eq.
QO que $ne retorna para null?
Anull é igual a null (false); null difere de outros valores (true).
QO $ne consegue filtrar campos ausentes?
AEm expressões, um campo ausente conta como null, então retorna true contra um valor não null.
