.. _nonstandard:

================= Nonstandard UUIDs

.. toctree:: :titlesonly: :hidden:

nonstandard/version6
nonstandard/guid
nonstandard/other

Outside of RFC 9562_ (formerly 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.

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 9562_ 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 9562_. Rather than reject these identifiers, ramsey/uuid returns them with the special Nonstandard\Uuid instance type. For more details, see :ref:nonstandard.other.

.. _RFC 4122: https://www.rfc-editor.org/rfc/rfc4122 .. _RFC 9562: https://www.rfc-editor.org/rfc/rfc9562