/ /

$bitsAnyClear (query predicate operador)

$bitsAnyClear

$bitsAnyClear coincide con los documentos donde cualquiera de las posiciones de bits dadas por la consulta está libre (es0 decir,) field en.

{ <field>: { $bitsAnyClear: <numeric bitmask> } }

{ <field>: { $bitsAnyClear: < BinData bitmask> } }

{ <field>: { $bitsAnyClear: [ <position1>, <position2>, ... ] } }

The field value must be either numeric or a BinData instance. Otherwise, $bitsAnyClear will not match the current document.

Máscara de bits numérica: You can provide a numeric bitmask to be matched against the operand field. The bitmask must be a non-negative 64-bit signed integer. Otherwise, $bitsAnyClear returns an error.
BinData Bitmask: También puedes usar una instancia BinData arbitrariamente grande como máscara de bits.
Lista de cargos: Si se consulta una lista de posiciones de bits, cada <position> debe ser un número entero no negativo. Las posiciones de bits comienzan en 0 desde el bit menos significativo. Por ejemplo, el número decimal 254 tendría las siguientes posiciones de bits:

Valor de bit	1	1	1	1	1	1	1	0
Posición	7	6	5	4	3	2	1	0

Comportamiento

La endianidad de tu sistema depende de la arquitectura de tu equipo. Los números en los datos BSON siempre se almacenan como little-endian, y si tu sistema es big-endian esto significa que los datos numéricos se convierten entre big y little endian.

En el contexto de los operadores de expresiones de coincidencia de prueba de bits:

BinData values act as bitmasks and are interpreted as though they are arbitrary-length unsigned little-endian numbers. The lowest-addressable byte is always interpreted as the least significant byte. Similarly, the highest-addressable byte in the BinData is always interpreted as the most significant byte.

Indexes

Queries cannot use indexes for the $bitsAnyClear portion of a query, although the other portions of a query can use indexes, if applicable.

Valores de punto flotante

$bitsAnyClear no coincidirán con valores numéricos que no puedan ser representados como un entero de 64 bits con signo. Este puede ser el caso si un valor es demasiado grande o demasiado pequeño para caber en un entero con signo de 64 bits, o si tiene un componente fraccionario.

Extensión de signo

Numbers are sign extended. For example, $bitsAnyClear considers bit position 200 to be set for the negative number -5, but bit position 200 to be clear for the positive number +5.

En cambio, las instancias de BinData tienen una extensión cero. Por ejemplo, dado el siguiente documento:

db.collection.insertOne({ x: BinData(0, "ww=="), binaryValueofA: "11000011" })

$bitsAnyClear will consider all bits outside of x to be clear.

Ejemplos

Los siguientes ejemplos usarán una colección con los siguientes documentos:

db.collection.insertMany([
  { _id: 1, a: 54, binaryValueofA: "00110110" },
  { _id: 2, a: 20, binaryValueofA: "00010100" },
  { _id: 3, a: 20.0, binaryValueofA: "00010100" },
  { _id: 4, a: BinData(0, "Zg=="), binaryValueofA: "01100110" }
])

arreglo de Posición de Bits

La siguiente consulta utiliza el operador para comprobar si el $bitsAnyClear campo a tiene la posición de bit 1 o 5 la posición de bit desactivada, donde el bit menos significativo es la 0 posición.

db.collection.find( { a: { $bitsAnyClear: [ 1, 5 ] } } )

La query coincide con los siguientes documentos:

{ "_id" : 2, "a" : 20, "binaryValueofA" : "00010100" }
{ "_id" : 3, "a" : 20.0, "binaryValueofA" : "00010100" }

Integer Bitmask

La siguiente consulta utiliza el operador para comprobar si el $bitsAnyClear campo a tiene algún bit desactivado en las 0 posiciones, 1 y 5 (la representación binaria de la máscara de bits 35 00100011es).

db.collection.find( { a: { $bitsAnyClear: 35 } } )

La query coincide con los siguientes documentos:

{ "_id" : 1, "a" : 54, "binaryValueofA" : "00110110" }
{ "_id" : 2, "a" : 20, "binaryValueofA" : "00010100" }
{ "_id" : 3, "a" : 20.0, "binaryValueofA" : "00010100" }
{ "_id" : 4, "a" : BinData(0,"Zg=="), "binaryValueofA" : "01100110" }

BinData Bitmask

La siguiente consulta utiliza el operador para comprobar si el $bitsAnyClear campo a tiene algún bit libre en las posiciones 4 y 5 (la representación binaria BinData(0, "MA==") de 00110000 es).

db.collection.find( { a: { $bitsAnyClear: BinData(0, "MA==") } } )

La query coincide con los siguientes documentos:

{ "_id" : 2, "a" : 20, "binaryValueofA" : "00010100" }
{ "_id" : 3, "a" : 20.0, "binaryValueofA" : "00010100" }
{ "_id" : 4, "a" : BinData(0,"Zg=="), "binaryValueofA" : "01100110" }

Volver

$bitsAllSet

$bitsAnySet