TBSL
====
Class: ``Infocyph\\UID\\TBSL``
TBSL is a project-specific, time-based, lexicographically sortable uppercase hex ID.
Format
------
- 20 hex chars (10 bytes)
- ``TBSL::isValid()`` verifies ``^[0-9A-F]{20}$``
Generation
----------
.. code-block:: php
<?php
use Infocyph\UID\TBSL;
$id = TBSL::generate();
$idWithMachine = TBSL::generate(machineId: 9);
$idWithSequence = TBSL::generate(machineId: 9, sequenced: true);
Configuration Object
--------------------
Use ``Infocyph\\UID\\Configuration\\TBSLConfig`` for:
- fixed or callback-resolved machine ID
- toggling ``sequenced`` mode
- custom sequence provider
- clock-backward policy
- output type (string/int/binary)
.. code-block:: php
<?php
use Infocyph\UID\Configuration\TBSLConfig;
use Infocyph\UID\TBSL;
$config = new TBSLConfig(machineId: 9, sequenced: true);
$id = TBSL::generateWithConfig($config);
Parsing
-------
.. code-block:: php
<?php
use Infocyph\UID\TBSL;
$parsed = TBSL::parse($id);
``parse()`` output:
- ``isValid`` (bool)
- ``time`` (DateTimeImmutable|null)
- ``machineId`` (int|null)
Binary and Alternate Bases
--------------------------
- ``TBSL::toBytes($id)`` / ``TBSL::fromBytes($bytes)``
- ``TBSL::toBase($id, $base)`` / ``TBSL::fromBase($encoded, $base)``
Supported bases: ``16``, ``32``, ``36``, ``58``, ``62``.
Exception Type
--------------
TBSL APIs throw ``Infocyph\\UID\\Exceptions\\UIDException`` for validation/runtime issues.
|
Download
