Binary.createFromBase64()

Nesta página

Definição

Compatibilidade
Sintaxe
Exemplos

Definição

Cria um objeto binário a partir de um valor base64.

Compatibilidade

Esse método está disponível em implantações hospedadas nos seguintes ambientes:

MongoDB Atlas: o serviço totalmente gerenciado para implantações do MongoDB na nuvem

MongoDB Enterprise: a versão autogerenciada e baseada em assinatura do MongoDB
MongoDB Community: uma versão com código disponível, de uso gratuito e autogerenciada do MongoDB

Sintaxe

Binary.createFromBase64( <base64String> [ , <subType> ] )

Campos de método

O método aceita os seguintes campos:

Campo

Tipo

Descrição

base64String

String

Especifica uma string que contém um valor base64. Por exemplo, "SGVsbG8gV29ybGQhCg==".

subType

Inteiro

Opcional. Especifica um subtipo binário.

Valor	Descrição
0	Subtipo binário genérico
1	Função
2	Array de bytes (obsoleto)
3	UUID antigo (obsoleto)
4	UUID
5	md5
128 a 255	Definido pelo usuário

Exemplos

Os exemplos a seguir mostram como adicionar um objeto binário a um documento usando Binary.createFromBase64() e como o objeto binário aparece na saída quando recuperado.

Criar collection contendo documento com objeto binário

O exemplo a seguir cria uma collection chamada binaryObjectsFromBase64:

db.binaryObjectsFromBase64.insertOne( {
   _id: 0,
   binaryObject: Binary.createFromBase64( "SGVsbG8gV29ybGQhCg==" )
} )

O campo binaryObject contém o objeto binário criado a partir da string especificada em Binary.createFromBase64().

Recuperar documento da coleção com objeto binário

O exemplo a seguir recupera o documento:

db.binaryObjectsFromBase64.findOne( { _id: 0 } )

Observação

A partir de mongosh 2.0.0, objetos binários são mostrados como valores Binary.createFromBase64( <base64String> ) em vez de valores Binary( Buffer.from( <base64String> ) ) . Isso apenas altera a exibição de valores binários.

Exemplo de saída, começando em mongosh 2.0.0:

{
   _id: 0,
   binaryObject: Binary.createFromBase64("SGVsbG8gV29ybGQhCg==")
}

Voltar

Construtores de objetos

Binary.createFromHexString