HexData()

On this page

Definition

Syntax
Command Fields
Examples
Learn More

Definition

Creates a binary data object from hexadecimal data.

Syntax

HexData() has the following syntax:

HexData( <subType>, <buffer> )

Returns:	Binary data object.

Command Fields

The command takes these fields:

Field

Type

Necessity

Description

subType

integer

Required

Specify a data subtype:

Subtype	Description
0	Generic binary subtype
1	Function
2	Byte Array
3	OLD UUID
4	UUID
5	MD5
128	User defined

buffer

string

Required

Hexadecimal data. The string is decoded up to the first character that is not a valid hexadecimal digit. You can use upper or lower case letters in the hexadecimal string.

Examples

Create the example collection

Use HexData() to insert a document with binary data created from a hexadecimal string into a test collection:

db.hexCollection.insertOne( {
   _id: 0, hexField: HexData( 0, "123456abcdef" )
} )

Retrieve the document

To return the document, run the following find command:

db.hexCollection.find()

Output shows the hexField value as a base 64 number using Binary.createFromBase64():

[ { _id: 0, hexField: Binary.createFromBase64('EjRWq83v', 0) } ]

Learn More

Back

Date

ObjectId