UUID Functions
This section describes functions that facilitate creation and use of immutable universally unique identifiers (UUID).
For general information about UUIDs, see https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/util/UUID.html.
For information about the uuid type, see Data Types.
The following functions for UUID described here are:
uuidCreateFromHexString
This function takes a string representation of a UUID and converts it to the uuid type.
uuid uuidCreateFromHexString ( string aString )Parameter | Description |
|---|---|
uuidString | A string representation of a UUID |
Returns | A UUID based on the input string Note! The format of the string is validated but not the content. The function returns null if the format of the string is incorrect. |
Example - uuidCreateFromHexString
The following example converts a string to a UUID:
uuid getUuid (string s) {
uuid u = uuidCreateFromHexString(s);
if(u==null) {
//Incorrect UUID format
}
return u;
} uuidCreateRandom
This function generates a random UUID.
uuid uuidCreateRandom ( void )Parameter | Description |
|---|---|
Returns | A version 4 UUID (randomly generated UUID) |
Example - uuidCreateRandom
The following example creates a random UUID:
uuid getUuid() {
return uuidCreateRandom();
}uuidGetVersion
This function returns the version of a UUID. The version number describes the type of the UUID, e g time-based, DCE security, name-based, and randomly generated UUID. For instance, a UUID generated by the function uuidCreateRandom is 4 (randomly generated UUID).
int uuidGetVersion ( uuid aUuid )Parameter | Description |
|---|---|
aUuid | The UUID for which you want to retrieve the version. |
Returns | The version of the UUID, or -1 if the UUID in the argument is null. |
Example - uuidGetVersion
The following example retrieves the version from a UUID:
uuid getUuid (string s) {
uuid u = uuidCreateFromHexString(s);
if(u==null) {
debug("Incorrect UUID format");
} else if (uuidGetVersion(u)<0) {
debug("Invalid UUID");
}
return u;
}uuidString
This function converts a UUID to a string.
string uuidString ( aUuid )Parameter | Description |
|---|---|
aUuid | The UUID that you want to convert |
Returns | The UUID represented as a string |
Example - uuidString
The result of the following two examples are identical:
uuid aUuid = uuidCreateRandom();
string s = (string) aUuid;´uuid aUuid = uuidCreateRandom();
string s = uuidString(aUuid);