LibXR::HardwareContainer Class Reference

#include <hardware.hpp>

Collaboration diagram for LibXR::HardwareContainer:

Data Structures
struct	AliasEntry
	一条硬件别名记录 One registered hardware-alias record More...

Public Member Functions
template<typename... Entries>
constexpr	HardwareContainer (Entries &&... entries)
template<typename T >
T *	Find (const char *alias) const
template<typename T >
T *	Find (const std::initializer_list< const char * > ALIASES) const
template<typename T >
T *	FindOrExit (std::initializer_list< const char * > aliases) const
template<typename T >
void	Register (const Entry< T > &entry)
	注册一个硬件条目

Protected Attributes
LibXR::LockFreeList	alias_list_
	当前已注册的全部别名链表 / List of all currently registered aliases.

Detailed Description

硬件容器类 / Hardware container

Each registered alias is stored together with the object's erased pointer and its TypeID, so name lookup and type filtering happen in one pass. 每个注册别名都会连同对象的擦除指针和对应 TypeID 一起存储，因此名称匹配和类型过滤 会在一次遍历里同时完成。

Definition at line 44 of file hardware.hpp.

Constructor & Destructor Documentation

HardwareContainer()

template<typename... Entries>

LibXR::HardwareContainer::HardwareContainer ( Entries &&... entries )

inlineconstexpr

构造并注册所有别名 / Construct and register aliases

Parameters

entries

硬件条目列表 / Hardware entry list

Definition at line 52 of file hardware.hpp.

  {
    (Register(std::forward<Entries>(entries)), ...);
  }

Member Function Documentation

Find() [1/2]

template<typename T >

T * LibXR::HardwareContainer::Find ( const char * alias ) const

inline

查找设备（单个别名） / Find device by alias

Note

alias 必须非空。 alias must be non-null.

Definition at line 63 of file hardware.hpp.

  {
    ASSERT(alias != nullptr);
    T* result = nullptr;
    const auto wanted_id = TypeID::GetID<T>();
    alias_list_.Foreach<AliasEntry>(
        [&](AliasEntry& entry)
        {
          if (std::strcmp(entry.name, alias) == 0 && entry.id == wanted_id)
          {
            result = static_cast<T*>(entry.object);
            return ErrorCode::FAILED;
          }
          return ErrorCode::OK;
        });
    return result;
  }

Find() [2/2]

template<typename T >

T * LibXR::HardwareContainer::Find ( const std::initializer_list< const char * > ALIASES ) const

inline

查找设备（多个别名） / Find device with fallback aliases

Note

ALIASES 中的每个别名都必须非空。 Every alias in ALIASES must be non-null.

Definition at line 87 of file hardware.hpp.

  {
    for (const auto& alias : ALIASES)
    {
      ASSERT(alias != nullptr);
      if (T* obj = Find<T>(alias))
      {
        return obj;
      }
    }
    return nullptr;
  }

FindOrExit()

template<typename T >

T * LibXR::HardwareContainer::FindOrExit ( std::initializer_list< const char * > aliases ) const

inline

查找或强约束失败 / Find or REQUIRE if not found

Note

aliases 中的每个别名都必须非空。 Every alias in aliases must be non-null.

Definition at line 106 of file hardware.hpp.

  {
    T* result = Find<T>(aliases);
    REQUIRE(result != nullptr);
    return result;
  }

Register()

template<typename T >

void LibXR::HardwareContainer::Register ( const Entry< T > & entry )

inline

注册一个硬件条目

Register a hardware entry

Note

包含动态内存分配。 Contains dynamic memory allocation.

entry.aliases 中的每个别名都必须非空。 Every alias in entry.aliases must be non-null.

Definition at line 123 of file hardware.hpp.

  {
    for (const auto& alias : entry.aliases)
    {
      ASSERT(alias != nullptr);
      auto node = new (std::align_val_t(LibXR::CACHE_LINE_SIZE))
          LibXR::LockFreeList::Node<AliasEntry>{alias, static_cast<void*>(&entry.object),
                                                TypeID::GetID<T>()};
      alias_list_.Add(*node);
    }
  }

Field Documentation

alias_list_

LibXR::LockFreeList LibXR::HardwareContainer::alias_list_

mutableprotected

当前已注册的全部别名链表 / List of all currently registered aliases.

Definition at line 147 of file hardware.hpp.

---

The documentation for this class was generated from the following file:

• src/middleware/app_framework/hardware.hpp