Docs Home → Develop Applications → MongoDB Manual
ObjectId.createFromHexString()
On this page
Definition
Creates an ObjectId from a hexadecimal value.
Syntax
ObjectId.createFromHexString( <hexadecimalString> )
The hexadecimalString field specifies a string that contains a 24
character hexadecimal value. For example,
"64c13ab08edf48a008793cac".
Examples
The following examples show how to add an object identifier to a
document using ObjectId.createFromHexString() and how the object
identifier appears in the output when retrieved.
Create Collection Containing Document with Object Identifier
The following example creates a collection named
objectIdentifierValuesFromHex:
db.objectIdentifierValuesFromHex.insertOne( { _id: 0, objectIdentifierValue: ObjectId.createFromHexString( "64c13ab08edf48a008793cac" ) } )
The objectIdentifierValue field contains the object identifier
created from the hexadecimal string specified in
ObjectId.createFromHexString().
Retrieve Document from Collection with Object Identifier
The following example retrieves the document:
db.objectIdentifierValuesFromHex.findOne( { _id: 0 } )
Example output:
{ _id: 0, objectIdentifierValue: ObjectId("64c13ab08edf48a008793cac") }