blob: f909e1f1dbbcead47155d26aefd774042e8ed929 [file] [edit]
STRING:UUID
-----------
.. |genex-family| replace::
:ref:`genex-family-string-generating-generator-expressions`
.. include:: ../manual/include/GENEX_FAMILY.rst
Syntax
^^^^^^
.. code-block:: cmake
$<STRING:UUID,NAMESPACE:namespace,TYPE:(MD5|SHA1)[,NAME:name][,CASE:(LOWER|UPPER)]>
.. versionadded:: 4.3
Create a universally unique identifier (aka GUID) as per RFC4122. A UUID has the
format ``xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx`` where each ``x`` represents an
hexadecimal character.
The UUID is based on the hash of the combined values of:
``NAMESPACE:namespace``
``namespace`` which has to be a valid UUID.
``NAME:name``
``name`` is an arbitrary string.
``TYPE:``
The hash algorithm can be either:
``MD5``
Version 3 UUID.
``SHA1``
Version 5 UUID.
``CASE:``
Specify the case of the hexadecimal characters.
``LOWER``
Hexadecimal characters are all of lowercase. This is the default.
``UPPER``
Hexadecimal characters are all of uppercase.