Skip to content

Latest commit

 

History

History
40 lines (30 loc) · 1.38 KB

nonstandard.rst

File metadata and controls

40 lines (30 loc) · 1.38 KB

Nonstandard UUIDs

.. toctree::
    :titlesonly:
    :hidden:

    nonstandard/version6
    nonstandard/guid
    nonstandard/other

Outside of RFC 4122, other types of UUIDs are in-use, following rules of their own. Some of these are on their way to becoming accepted standards, while others have historical reasons for remaining valid today. Still, others are completely random and do not follow any rules.

For these cases, ramsey/uuid provides a special functionality to handle these alternate, nonstandard forms.

Version 6: Ordered-time
This is a proposed version of UUID that combines the features of a :ref:`version 1 UUID <rfc4122.version1>` with a monotonically increasing UUID. For more details, see :ref:`nonstandard.version6`.
Globally Unique Identifiers (GUIDs)
A globally unique identifier, or GUID, is often used as a synonym for UUID. A key difference is the order of the bytes. Any RFC 4122 version UUID may be represented as a GUID. For more details, see :ref:`nonstandard.guid`.
Other Nonstandard UUIDs
Sometimes, UUID string or byte representations don't follow RFC 4122. Rather than reject these identifiers, ramsey/uuid returns them with the special Nonstandard\Uuid instance type. For more details, see :ref:`nonstandard.other`.