Menu Docs
Página inicial do Docs
/
Manual do MongoDB
/ / /

BinData()

Nesta página

  • Definição
  • Comportamento
  • Exemplos

Cria um objeto de dados binários.

BinData tem a seguinte sintaxe:

BinData(<sub_type>,<buffer>)
Parâmetro
Tipo
Descrição
sub_type
inteiro
Osubtipo binário
buffer
string
O objeto de buffer contendo dados binários. Deve ser um valor de string codificada 64 base.
Retorna:Um objeto de dados binários.

Especifique um dos seguintes valores para sub_type:

Número
Descrição
0
Subtipo binário genérico
1
Dados de Função
2
Binário (antigo)
3
UUID (antigo)
4
UUID
5
md5
6
Valor BSON criptografado
7

Dados de série temporal compactados

Novidades na versão 5.2.

8
Dados confidenciais, como uma chave ou segredo. O MongoDB não registra valores literais para dados binários com subtipo 8. Em vez disso, o MongoDB registra um valor de espaço reservado de ###.
9
Dados vetoriais, que são arrays densamente compactadas de números do mesmo tipo.
128
Dados personalizados

Aendianidade do seu sistema depende da arquitetura da sua máquina. Os números nos dados BSON são sempre armazenados como little-endian, se o seu sistema for big-endian , isso significa que os dados numéricos são convertidos entre big e little endian.

No contexto dos operadores de expressão de correspondência de teste de bit:

BinData Os valores atuam como bitmasks e são interpretados como se fossem números little-endian sem sinal de comprimento arbitrário. O byte endereçável mais baixo é sempre interpretado como o byte menos significativo. Da mesma forma, o byte endereçável de maior valor no BinData é sempre interpretado como o byte mais significativo.

Utilize o construtor BinData() para criar a variável bdata.

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

Insira o objeto na coleção testbin.

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

Consulte a coleção testbin para obter o documento inserido.

db.testbin.find()

Você pode ver o buffer binário armazenado na coleção.

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

Utilize o construtor BinData() para criar a variável bdata.

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

Use .length() para retornar o comprimento em bits do objeto.

bdata.length()

O valor devolvido é:

16

Voltar

Binary.createFromHexString