$bitsAnyClear (Qualquer Bit Limpo)
Última atualização: 2026-10-09
$bitsAnyClear (Qualquer Bit Limpo)
$bitsAnyClear corresponde a documentos onde pelo menos um dos bits nas posições fornecidas é 0. `{ flags: { $bitsAnyClear: 7 } }` (binário 111) corresponde a documentos onde o bit 0, 1 ou 2 está limpo. É mais permissivo que $bitsAllClear. Apenas inteiros e BinData.
| Categoria | Bit a Bit |
|---|---|
| Versão do MongoDB | 3.2+ |
| Idioma do Exemplo | mongosh (Shell) |
📝 Sintaxe
{ <campo>: { $bitsAnyClear: <máscara de bits ou array de posições> } }⚙️ Parâmetros
| campo | O campo inteiro ou BinData a corresponder. |
|---|---|
| máscara de bits | Uma máscara de bits inteira ou matriz de posições, por exemplo 7 ou [0, 1, 2]. |
Retorno：Cursor dos documentos correspondentes
▶ Exemplo
Execute os comandos abaixo no seu mongosh local (requer um mongod em execução):
// $bitsAnyClear: pelo menos um dos bits 0-2 é 0
// 7 em binário é 111
db.users.find({ flags: { $bitsAnyClear: 7 } })
// Array de posições
db.users.find({ flags: { $bitsAnyClear: [0, 1, 2] } })Saída：
// Retorna usuários cujos flags têm pelo menos um dos bits 0-2 limpo📌 Notas
- Diferente de $bitsAllClear, um único bit limpo é suficiente
- Bom para verificações de tem-algum-flag-faltando
- Apenas int, long e BinData
🏷️ Tags Relacionados
💡 Casos Relacionados
Mais casos práticos em breve.
📚 Tutoriais Relacionados
❓ Perguntas Frequentes
QQual é a diferença entre $bitsAnyClear e $bitsAllClear?
A$bitsAnyClear corresponde com um único bit limpo; $bitsAllClear exige todos os bits listados limpos.
QComo verifico que um bit não está definido?
A{ $bitsAnyClear: [2] } testa se o bit 2 é 0.
QEle suporta floats?
ANão, apenas int, long e BinData.
