Converts a universally unique identifier (UUID) value into a globally unique identifier (GUID) value. This function returns a GUID as a 36-character string value consisting of 32 hexadecimal digits (0 through 9 and A through F) and 4 hyphens formatted as follows (where X is a hexadecimal digit): XXXXXXXX—XXXX—XXXX—XXXX—XXXXXXXXXXXX.

Syntax

GUID [( UUID )]
UUID
An optional 16-byte raw UUID value to be converted. If the specified UUID is not exactly 16 bytes in length, the AVM returns the Unknown value (?). If not specified, the AVM generates a UUID and then converts it into a GUID.

Examples

The following code fragment illustrates how to use the GUID function:

DEFINE VARIABLE MyUUID AS RAW       NO-UNDO.
DEFINE VARIABLE vGUID  AS CHARACTER NO-UNDO.

ASSIGN
  MyUUID = GENERATE-UUID
  vGUID  = GUID(MyUUID).

The following code fragment generates a GUID value:

DEFINE VARIABLE vGUID  AS CHARACTER NO-UNDO.

ASSIGN
    vGUID  = GUID.

See also

GENERATE-UUID function