Note: There is a newer version (1.10.0) of this package available. Click here to view docs for the latest version.
Module uuid
ballerina/uuid Ballerina library
1.9.0
Functions
createRandomUuid
Isolated Function
function createRandomUuid() returns stringReturns a UUID of type 4 as a string. This function provides a convenient alias for 'createType4AsString()'.
string newUUID = uuid:createRandomUuid();
Return Type
- string - UUID of type 4 as a string
createType1AsRecord
Isolated Function
Returns a UUID of type 1 as a UUID record.
uuid:Uuid uuid1 = check uuid:createType1AsRecord();
createType1AsString
Isolated Function
function createType1AsString() returns stringReturns a UUID of type 1 as a string.
string uuid1 = uuid:createType1AsString();
Return Type
- string - UUID of type 1 as a string
createType3AsRecord
Isolated Function
function createType3AsRecord(NamespaceUUID namespace, string name) returns Uuid|ErrorReturns a UUID of type 3 as a UUID record.
uuid:Uuid uuid3 = check uuid:createType3AsRecord(uuid:NAME_SPACE_DNS, “ballerina.io”);
Parameters
- namespace NamespaceUUID - String representation for a pre-defined namespace UUID
- name string - A name within the namespace
createType3AsString
Isolated Function
function createType3AsString(NamespaceUUID namespace, string name) returns string|ErrorReturns a UUID of type 3 as a string.
string uuid3 = check uuid:createType3AsString(uuid:NAME_SPACE_DNS, “ballerina.io”);
Parameters
- namespace NamespaceUUID - String representation for a pre-defined namespace UUID
- name string - A name within the namespace
createType4AsRecord
Isolated Function
Returns a UUID of type 4 as a UUID record.
uuid:Uuid uuid4 = check uuid:createType4AsRecord();
createType4AsString
Isolated Function
function createType4AsString() returns stringReturns a UUID of type 4 as a string.
string uuid4 = uuid:createType4AsString();
Return Type
- string - UUID of type 4 as a string
createType5AsRecord
Isolated Function
function createType5AsRecord(NamespaceUUID namespace, string name) returns Uuid|ErrorReturns a UUID of type 5 as a UUID record.
uuid:Uuid uuid5 = check uuid:createType5AsRecord(uuid:NAME_SPACE_DNS, “ballerina.io”);
Parameters
- namespace NamespaceUUID - String representation for a pre-defined namespace UUID
- name string - A name within the namespace
createType5AsString
Isolated Function
function createType5AsString(NamespaceUUID namespace, string name) returns string|ErrorReturns a UUID of type 5 as a string.
string uuid5 = check uuid:createType5AsString(uuid:NAME_SPACE_DNS, “ballerina.io”);
Parameters
- namespace NamespaceUUID - String representation for a pre-defined namespace UUID
- name string - A name within the namespace
getVersion
Isolated Function
Detect RFC version of a UUID. Returns an error if the UUID is invalid.
uuid:Version v = check uuid:getVersion("4397465e-35f9-11eb-adc1-0242ac120002");
Parameters
- uuid string - UUID string to be checked
nilAsRecord
Isolated Function
function nilAsRecord() returns UuidReturns a nil UUID as a UUID record.
uuid:Uuid nilUUID = uuid:nilAsRecord();
Return Type
- Uuid - nil UUID
nilAsString
Isolated Function
function nilAsString() returns stringReturns a nil UUID as a string.
string nilUUID = uuid:nilAsString();
Return Type
- string - nil UUID
toBytes
Isolated Function
Converts to an array of bytes. Returns an error if the UUID is invalid.
byte[] b = check uuid:toBytes(“6ec0bd7f-11c0-43da-975e-2aesass0b”);
Return Type
- byte[]|Error - UUID as bytes, or else a
uuid:Error
toRecord
Isolated Function
Converts to a UUID record. Returns an error if the UUID is invalid.
uuid:Uuid r1 = check uuid:toRecord("4397465e-35f9-11eb-adc1-0242ac120002"); uuid:Uuid r2 = check uuid:toRecord([10, 20, 30]);
Parameters
- uuid string|byte[] - UUID to be converted
toString
Isolated Function
Converts to a UUID string. Returns an error if the UUID is invalid.
string s = check uuid:toString([5, 12, 16, 35]);
Parameters
- uuid byte[]|Uuid - UUID to be converted
validate
Isolated Function
Test a string to see if it is a valid UUID.
boolean valid = uuid:validate("4397465e-35f9-11eb-adc1-0242ac120002");
Parameters
- uuid string - UUID string to be validated
Return Type
- boolean - true if a valied UUID, false if not
Enums
uuid: NamespaceUUID
Represents UUIDs strings of well known namespace IDs.
Members
NAME_SPACE_DNS - Namespace is a fully-qualified domain name
NAME_SPACE_URL - Namespace is a URL
NAME_SPACE_OID - Namespace is an ISO OID
NAME_SPACE_X500 - Namespace is an X.500 DN (in DER or a text output format)
NAME_SPACE_NIL - Empty UUID
uuid: Version
Represents the UUID versions.
Members
V1 - UUID generated using the MAC address of the computer and the time of generation
V3 - UUID generated using MD5 hashing and application-provided text string
V4 - UUID generated using a pseudo-random number generator
V5 - UUID generated using SHA-1 hashing and application-provided text string
Records
uuid: Uuid
Read Only
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
Errors
uuid: Error
Distinct
Represents UUID module related errors.