Module uuid
ballerina/uuid
Overview
This module provides APIs to generate and inspect UUIDs (Universally Unique Identifiers).
The UUIDs are generated based on the RFC 4122 standard. This module supports generating 4 versions of UUIDs.
Version 1
Generated using the MAC address of the computer and the time of generation.
Version 3
Cryptographic hashing and application-provided text strings are used to generate a UUID. MD5 hashing is used.
Version 4
Uses a pseudo-random number generator to generate the UUID. Every bit of the string is randomly generated.
Version 5
Similar to Version 3 but uses SHA-1 instead of MD5.
Other operations include validating a given UUID string and getting the version of a UUID string.
For information on the operations, which you can perform with the uuid module, see the below Functions.
Functions
createType1AsRecord
Returns a UUID of type 1 as a UUID record.
createType1AsString
function createType1AsString() returns stringReturns a UUID of type 1 as a string.
Return Type
- string - UUID of type 1 as a string
createType3AsRecord
function createType3AsRecord(NamespaceUUID namespace, string name) returns Uuid|ErrorReturns a UUID of type 3 as a UUID record.
Parameters
- namespace NamespaceUUID - String representation for a pre-defined namespace UUID
- name string - A name within the namespace
createType3AsString
function createType3AsString(NamespaceUUID namespace, string name) returns string|ErrorReturns a UUID of type 3 as a string.
Parameters
- namespace NamespaceUUID - String representation for a pre-defined namespace UUID
- name string - A name within the namespace
createType4AsRecord
Returns a UUID of type 4 as a UUID record.
createType4AsString
function createType4AsString() returns stringReturns a UUID of type 4 as a string.
Return Type
- string - UUID of type 4 as a string
createType5AsRecord
function createType5AsRecord(NamespaceUUID namespace, string name) returns Uuid|ErrorReturns a UUID of type 5 as a UUID record.
Parameters
- namespace NamespaceUUID - String representation for a pre-defined namespace UUID
- name string - A name within the namespace
createType5AsString
function createType5AsString(NamespaceUUID namespace, string name) returns string|ErrorReturns a UUID of type 5 as a string.
Parameters
- namespace NamespaceUUID - String representation for a pre-defined namespace UUID
- name string - A name within the namespace
getVersion
Detect RFC version of a UUID. Returns an error if the UUID is invalid.
Parameters
- uuid string - UUID string to be checked
nilAsRecord
function nilAsRecord() returns UuidReturns a nil UUID as a UUID record.
Return Type
- Uuid - nil UUID
nilAsString
function nilAsString() returns stringReturns a nil UUID as a string.
Return Type
- string - nil UUID
toBytes
Converts to an array of bytes. Returns an error if the UUID is invalid.
Return Type
- byte[]|Error - UUID as bytes, or else a
uuid:Error
toRecord
Converts to a UUID record. Returns an error if the UUID is invalid.
Parameters
- uuid string|byte[] - UUID to be converted
toString
Converts to a UUID string. Returns an error if the UUID is invalid.
Parameters
- uuid byte[]|Uuid - UUID to be converted
validate
Test a string to see if it is a valid UUID.
Parameters
- uuid string - UUID string to be validated
Return Type
- boolean - true if a valied UUID, false if not
Records
uuid: Uuid
Represents a UUID.
Fields
- timeLow Unsigned32 - The low field of the timestamp
- timeMid Unsigned16 - The middle field of the timestamp
- timeHiAndVersion Unsigned16 - The high field of the timestamp multiplexed with the version number
- clockSeqHiAndReserved Unsigned8 - The high field of the clock sequence multiplexed with the variant
- clockSeqLo Unsigned8 - The low field of the clock sequence
- node int - The spatially unique node identifier
Enums
uuid: NamespaceUUID
Represents UUIDs strings of well known namespace IDs.
Members
uuid: Version
Represents the UUID versions.
Members
Errors
uuid: Error
Represents UUID module related errors.