LibXR::Event Class Reference

事件管理系统，允许基于事件 ID 注册和触发回调函数。 Event management system that allows registration and triggering of callbacks based on event IDs. More...

#include <event.hpp>

Collaboration diagram for LibXR::Event:

Data Structures
struct	Block
	用于存储事件回调的数据结构。 Data structure for storing event callbacks. More...

Public Member Functions
	Event ()
	构造函数，初始化用于存储事件的红黑树。 Constructs an Event object with an empty red-black tree for event storage.
void	Register (uint32_t event, const Callback< uint32_t > &cb)
	为特定事件注册回调函数。 Registers a callback function for a specific event.
void	Active (uint32_t event)
	触发与特定事件关联的所有回调函数。 Triggers all callbacks associated with a specific event.
void	ActiveFromCallback (uint32_t event, bool in_isr)
	在中断服务程序（ISR）上下文中触发事件回调。 Triggers event callbacks from an interrupt service routine (ISR) context.
void	Bind (Event &sources, uint32_t source_event, uint32_t target_event)
	将源事件绑定到当前事件实例中的目标事件。 Binds an event from a source Event instance to a target event in the current Event instance.

Private Attributes
RBTree< uint32_t >	rbt_

Detailed Description

事件管理系统，允许基于事件 ID 注册和触发回调函数。 Event management system that allows registration and triggering of callbacks based on event IDs.

Definition at line 17 of file event.hpp.

Constructor & Destructor Documentation

Event()

LibXR::Event::Event ( )

inline

构造函数，初始化用于存储事件的红黑树。 Constructs an Event object with an empty red-black tree for event storage.

Definition at line 24 of file event.hpp.

      : rbt_([](const uint32_t &a, const uint32_t &b)
             { return static_cast<int>(a) - static_cast<int>(b); })
  {
  }

Member Function Documentation

Active()

void LibXR::Event::Active ( uint32_t  event )

inline

触发与特定事件关联的所有回调函数。 Triggers all callbacks associated with a specific event.

Parameters

event

要激活的事件 ID。 The event ID to activate.

Definition at line 58 of file event.hpp.

  {
    auto list = rbt_.Search<List>(event);
    if (!list)
    {
      return;
    }
 
    auto foreach_fun = [=](Block &block)
    {
      block.cb.Run(false, event);
      return ErrorCode::OK;
    };
 
    list->data_.Foreach<LibXR::Event::Block>(foreach_fun);
  }

ActiveFromCallback()

void LibXR::Event::ActiveFromCallback ( uint32_t  event, bool  in_isr  )

inline

在中断服务程序（ISR）上下文中触发事件回调。 Triggers event callbacks from an interrupt service routine (ISR) context.

Parameters

event	要激活的事件 ID。 The event ID to activate.
in_isr	是否从 ISR 调用该函数。 Whether the function is being called from an ISR.

Definition at line 82 of file event.hpp.

  {
    auto list = rbt_.Search<List>(event);
    if (!list)
    {
      return;
    }
 
    auto foreach_fun = [=](Block &block)
    {
      block.cb.Run(in_isr, event);
      return ErrorCode::OK;
    };
 
    list->data_.Foreach<Block>(foreach_fun);
  }

Bind()

void LibXR::Event::Bind ( Event &  sources, uint32_t  source_event, uint32_t  target_event  )

inline

将源事件绑定到当前事件实例中的目标事件。 Binds an event from a source Event instance to a target event in the current Event instance.

Parameters

sources	包含原始事件的源 Event 实例。 The source Event instance containing the original event.
source_event	源事件实例中的事件 ID。 The event ID in the source Event instance.
target_event	当前事件实例中的目标事件 ID。 The corresponding event ID in the current Event instance.

Definition at line 109 of file event.hpp.

  {
    struct BindBlock
    {
      Event *target;
      uint32_t event;
    };
 
    auto block = new BindBlock{this, target_event};
 
    auto bind_fun = [](bool in_isr, BindBlock *block, uint32_t event)
    {
      UNUSED(event);
      block->target->ActiveFromCallback(block->event, in_isr);
    };
 
    auto cb = Callback<uint32_t>::Create(bind_fun, block);
 
    sources.Register(source_event, cb);
  }

Register()

void LibXR::Event::Register ( uint32_t  event, const Callback< uint32_t > &  cb  )

inline

为特定事件注册回调函数。 Registers a callback function for a specific event.

Parameters

event	要注册回调的事件 ID。 The event ID to register the callback for.
cb	事件触发时执行的回调函数。 The callback function to be executed when the event occurs.

Definition at line 36 of file event.hpp.

  {
    auto list = rbt_.Search<List>(event);
 
    if (!list)
    {
      list = new RBTree<uint32_t>::Node<List>;
      rbt_.Insert(*list, event);
    }
 
    List::Node<Block> *node = new List::Node<Block>;
 
    node->data_.event = event;
    node->data_.cb = cb;
    list->data_.Add(*node);
  }

Field Documentation

rbt_

RBTree<uint32_t> LibXR::Event::rbt_

private

用于管理已注册事件的红黑树。 Red-black tree for managing registered events.

Definition at line 142 of file event.hpp.

---

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

• src/middleware/event.hpp