.. index:: pair: class; EE::UI::CSS::IdNameMap
.. _doxid-class_e_e_1_1_u_i_1_1_c_s_s_1_1_id_name_map:

template class EE::UI::CSS::IdNameMap
=====================================

.. toctree::
	:hidden:

Overview
~~~~~~~~

Maps dense process-local IDs to canonical names and back. :ref:`More...<details-class_e_e_1_1_u_i_1_1_c_s_s_1_1_id_name_map>`


.. ref-code-block:: cpp
	:class: doxyrest-overview-code-block

	#include <idnamemap.hpp>
	
	template <typename Id, std::size_t MaxIds>
	class IdNameMap {
	public:
		// methods
	
		bool :ref:`addBuiltin<doxid-class_e_e_1_1_u_i_1_1_c_s_s_1_1_id_name_map_1a766b5db42c938aef1495b4cdff6b1c2a>`(:ref:`Id<doxid-namespace_e_e_1_1_u_i_1_1_c_s_s_1a05099532fcfb8b0dd930aa68ac2d1329a490aa6e856ccf208a054389e47ce0d06>` id, const std::string& canonicalName);
		bool :ref:`addAlias<doxid-class_e_e_1_1_u_i_1_1_c_s_s_1_1_id_name_map_1a8765b7edd05a05dea7be181d1f960074>`(const std::string& alias, :ref:`Id<doxid-namespace_e_e_1_1_u_i_1_1_c_s_s_1a05099532fcfb8b0dd930aa68ac2d1329a490aa6e856ccf208a054389e47ce0d06>` target, bool couldBeDuplicate = false);
		bool :ref:`finalizeBuiltins<doxid-class_e_e_1_1_u_i_1_1_c_s_s_1_1_id_name_map_1ab66d057885ee6231dbb80d2fb0857f49>`();
		:ref:`Id<doxid-namespace_e_e_1_1_u_i_1_1_c_s_s_1a05099532fcfb8b0dd930aa68ac2d1329a490aa6e856ccf208a054389e47ce0d06>` :ref:`getId<doxid-class_e_e_1_1_u_i_1_1_c_s_s_1_1_id_name_map_1a012b907ccf7518f7ba1333ce19165afa>`(std::string_view name) const;
		:ref:`Id<doxid-namespace_e_e_1_1_u_i_1_1_c_s_s_1a05099532fcfb8b0dd930aa68ac2d1329a490aa6e856ccf208a054389e47ce0d06>` :target:`getId<doxid-class_e_e_1_1_u_i_1_1_c_s_s_1_1_id_name_map_1a946b5945bbe9a7c61f1fcb43c4e8265f>`(const std::string& name) const;
		:ref:`Id<doxid-namespace_e_e_1_1_u_i_1_1_c_s_s_1a05099532fcfb8b0dd930aa68ac2d1329a490aa6e856ccf208a054389e47ce0d06>` :target:`getId<doxid-class_e_e_1_1_u_i_1_1_c_s_s_1_1_id_name_map_1a5ec6958e18ac81492729473630d1ac6a>`(const char* name) const;
		const std::string& :ref:`getName<doxid-class_e_e_1_1_u_i_1_1_c_s_s_1_1_id_name_map_1ab101bdcf90bed177f05897dc17bb94d6>`(:ref:`Id<doxid-namespace_e_e_1_1_u_i_1_1_c_s_s_1a05099532fcfb8b0dd930aa68ac2d1329a490aa6e856ccf208a054389e47ce0d06>` id) const;
		:ref:`Id<doxid-namespace_e_e_1_1_u_i_1_1_c_s_s_1a05099532fcfb8b0dd930aa68ac2d1329a490aa6e856ccf208a054389e47ce0d06>` :ref:`getOrCreateId<doxid-class_e_e_1_1_u_i_1_1_c_s_s_1_1_id_name_map_1aaa299a3f31f5a5897554270751ee34f8>`(const std::string& canonicalName);
		bool :target:`contains<doxid-class_e_e_1_1_u_i_1_1_c_s_s_1_1_id_name_map_1a734880b99dc68b06de0faf3f5180c4c1>`(:ref:`Id<doxid-namespace_e_e_1_1_u_i_1_1_c_s_s_1a05099532fcfb8b0dd930aa68ac2d1329a490aa6e856ccf208a054389e47ce0d06>` id) const;
		bool :target:`contains<doxid-class_e_e_1_1_u_i_1_1_c_s_s_1_1_id_name_map_1a4da1dfd46579d565dccdff2eb1f9f9df>`(std::string_view name) const;
		bool :target:`contains<doxid-class_e_e_1_1_u_i_1_1_c_s_s_1_1_id_name_map_1a685a628a966c2755397d01d0f2fc855a>`(const std::string& name) const;
		bool :target:`contains<doxid-class_e_e_1_1_u_i_1_1_c_s_s_1_1_id_name_map_1af25bf80d9984e74d79b9493cd641bc29>`(const char* name) const;
		std::size_t :target:`size<doxid-class_e_e_1_1_u_i_1_1_c_s_s_1_1_id_name_map_1a47a481f46da6a751105ceb65228899d2>`() const;
	};
.. _details-class_e_e_1_1_u_i_1_1_c_s_s_1_1_id_name_map:

Detailed Documentation
~~~~~~~~~~~~~~~~~~~~~~

Maps dense process-local IDs to canonical names and back.

The map is the full-string reverse lookup for a dense ID space. It owns no definitions: it only tracks which ID belongs to which canonical (or alias) name. Built-in IDs must be registered with :ref:`addBuiltin() <doxid-class_e_e_1_1_u_i_1_1_c_s_s_1_1_id_name_map_1a766b5db42c938aef1495b4cdff6b1c2a>` before :ref:`finalizeBuiltins() <doxid-class_e_e_1_1_u_i_1_1_c_s_s_1_1_id_name_map_1ab66d057885ee6231dbb80d2fb0857f49>` seals the built-in range; runtime names then receive IDs via :ref:`getOrCreateId() <doxid-class_e_e_1_1_u_i_1_1_c_s_s_1_1_id_name_map_1aaa299a3f31f5a5897554270751ee34f8>`.

Numeric IDs are unstable internal identifiers. Names are the stable external representation. All names passed into the map are expected to already be lowercase and trimmed; the map performs no hidden normalization and no hash-only equality.

Methods
-------

.. index:: pair: function; addBuiltin
.. _doxid-class_e_e_1_1_u_i_1_1_c_s_s_1_1_id_name_map_1a766b5db42c938aef1495b4cdff6b1c2a:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	bool addBuiltin(:ref:`Id<doxid-namespace_e_e_1_1_u_i_1_1_c_s_s_1a05099532fcfb8b0dd930aa68ac2d1329a490aa6e856ccf208a054389e47ce0d06>` id, const std::string& canonicalName)

Registers a built-in ID with its canonical name.

Valid only before custom allocation begins. Rejects Invalid, IDs at or beyond MaxIds, duplicate names, and assigning a different name to an occupied ID.



.. rubric:: Returns:

true on success.

.. index:: pair: function; addAlias
.. _doxid-class_e_e_1_1_u_i_1_1_c_s_s_1_1_id_name_map_1a8765b7edd05a05dea7be181d1f960074:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	bool addAlias(const std::string& alias, :ref:`Id<doxid-namespace_e_e_1_1_u_i_1_1_c_s_s_1a05099532fcfb8b0dd930aa68ac2d1329a490aa6e856ccf208a054389e47ce0d06>` target, bool couldBeDuplicate = false)

Adds an alias that resolves to an existing ID.

Only the reverse entry is added; no ID is occupied and the canonical name is never replaced.

.. index:: pair: function; finalizeBuiltins
.. _doxid-class_e_e_1_1_u_i_1_1_c_s_s_1_1_id_name_map_1ab66d057885ee6231dbb80d2fb0857f49:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	bool finalizeBuiltins()

Seals the built-in range and enables runtime ID allocation.

Verifies every slot in [1, FirstCustomId) is populated. After this call :ref:`addBuiltin() <doxid-class_e_e_1_1_u_i_1_1_c_s_s_1_1_id_name_map_1a766b5db42c938aef1495b4cdff6b1c2a>` is permanently rejected.



.. rubric:: Returns:

true when all built-in slots are populated.

.. index:: pair: function; getId
.. _doxid-class_e_e_1_1_u_i_1_1_c_s_s_1_1_id_name_map_1a012b907ccf7518f7ba1333ce19165afa:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`Id<doxid-namespace_e_e_1_1_u_i_1_1_c_s_s_1a05099532fcfb8b0dd930aa68ac2d1329a490aa6e856ccf208a054389e47ce0d06>` getId(std::string_view name) const

Returns the ID for a canonical or alias name.



.. rubric:: Returns:

Invalid when the name is unknown.

.. index:: pair: function; getName
.. _doxid-class_e_e_1_1_u_i_1_1_c_s_s_1_1_id_name_map_1ab101bdcf90bed177f05897dc17bb94d6:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	const std::string& getName(:ref:`Id<doxid-namespace_e_e_1_1_u_i_1_1_c_s_s_1a05099532fcfb8b0dd930aa68ac2d1329a490aa6e856ccf208a054389e47ce0d06>` id) const

Returns the canonical name for an ID.



.. rubric:: Returns:

The empty invalid name for invalid, out-of-range, or unassigned IDs.

.. index:: pair: function; getOrCreateId
.. _doxid-class_e_e_1_1_u_i_1_1_c_s_s_1_1_id_name_map_1aaa299a3f31f5a5897554270751ee34f8:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`Id<doxid-namespace_e_e_1_1_u_i_1_1_c_s_s_1a05099532fcfb8b0dd930aa68ac2d1329a490aa6e856ccf208a054389e47ce0d06>` getOrCreateId(const std::string& canonicalName)

Returns the existing ID for a canonical name, or allocates a new custom ID.

Only valid after :ref:`finalizeBuiltins() <doxid-class_e_e_1_1_u_i_1_1_c_s_s_1_1_id_name_map_1ab66d057885ee6231dbb80d2fb0857f49>`. Reaching the capacity returns Invalid and logs a clear error containing the rejected name.