BinData() (método mongosh)

Definición

Crea un objeto de datos binarios.

BinData tiene la siguiente sintaxis:

BinData(<sub_type>,<buffer>)

Parameter	Tipo	Descripción
sub_type	entero	La subtipo binario
buffer	string	El objeto de búfer que contiene datos binarios. Debe ser un valor de cadena codificado en base 64.

Devuelve:	Un objeto de datos binarios.

Compatibilidad

Este método está disponible en implementaciones alojadas en los siguientes entornos:

• MongoDB Atlas: El servicio totalmente gestionado para implementaciones de MongoDB en la nube

• MongoDB Enterprise: La versión basada en suscripción y autogestionada de MongoDB

• MongoDB Community: La versión de MongoDB con código fuente disponible, de uso gratuito y autogestionada.

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 expresión de coincidencia de prueba de bits:

• $bitsAnySet

• $bitsAnyClear

• $bitsAllSet

• $bitsAllClear

Los valores BinData funcionan como máscaras de bits y se interpretan como si fueran números sin signo de longitud arbitraria en formato little-endian. El byte de menor dirección siempre se interpreta como el byte menos significativo. Del mismo modo, el byte direccionable más alto en el BinData siempre se interpreta como el byte más significativo.

Ejemplos

var bdata = BinData(0, "gf1UcxdHTJ2HQ/EGQrO7mQ==")

db.testbin.insertOne( { _id : 1, bin_data: bdata } )

db.testbin.find()

{
  _id: 1,
  bin_data: Binary(Buffer.from("81fd547317474c9d8743f10642b3bb99", "hex"), 0)
}

var bdata = BinData(0, "gf1UcxdHTJ2HQ/EGQrO7mQ==")

bdata.length()

16