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 )

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 )

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 )

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 )

uuid aUuid = uuidCreateRandom();
string s = (string) aUuid;

uuid aUuid = uuidCreateRandom();
string s = uuidString(aUuid);