Docs Menu
Docs Home
/
MongoDB Manual
/ / /

HexData()

On this page

  • Definition
  • Syntax
  • Command Fields
  • Examples
  • Learn More

Creates a binary data object from hexadecimal data.

HexData() has the following syntax:

HexData( <subType>, <buffer> )
Returns:Binary data object.

The command takes these fields:

Field
Type
Necessity
Description
subType
integer
Required

Specify a data subtype:

Number
Description
0
Generic binary subtype
1
Function data
2
Binary (old)
3
UUID (old)
4
UUID
5
MD5
6
Encrypted BSON value
7

Compressed time series data

New in version 5.2.

8
Sensitive data, such as a key or secret. MongoDB does not log literal values for binary data with subtype 8. Instead, MongoDB logs a placeholder value of ###.
9
Vector
128
Custom data
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.
1

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" )
} )
2

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) } ]

Back

Date