HSM_Create函数示例

代码示例

void HSM_Create(HSM _This, const char* name, HSM_STATE *initState)
{
    This->curState = initState;
    This->curState->handler(This, HSME_ENTRY, 0);
    This->curState->handler(This, HSME_INIT, 0);
}

详细解析

1. 设置初始状态

   This->curState = initState;
   

   • 将 HSM 对象的当前状态 curState 设置为传入的初始状态 initState。
   • 这意味着 This 指向的对象现在处于 initState 状态。

2. 调用进入事件处理器

   This->curState->handler(This, HSME_ENTRY, 0);
   

   • 调用当前状态的处理器函数 This->curState->handler，并传递事件 HSME_ENTRY 和参数 0。
   • HSME_ENTRY 表示进入该状态的事件。这个事件通常用于执行状态进入时需要的操作，例如初始化某些资源或设置特定的状态变量。

3. 调用初始化事件处理器

   This->curState->handler(This, HSME_INIT, 0);
   

   • 再次调用当前状态的处理器函数 This->curState->handler，但这次传递的是事件 HSME_INIT 和参数 0。
   • HSME_INIT 表示初始化该状态的事件。这个事件通常用于执行更详细的初始化操作，可能包括设置子状态、配置参数等。

具体执行过程

为了更好地理解这段代码的工作原理，我们可以假设一个简单的状态机结构和处理器函数的定义如下：

#include 

// 定义状态机对象
typedef struct {
    const char* name;
    HSM_STATE* curState;
} HSM;

// 定义状态事件类型
#define HSME_ENTRY 1
#define HSME_INIT 2

// 定义状态结构
typedef struct HSM_STATE_TAG {
    const char* name;
    struct HSM_STATE_TAG* parent;
    void (*handler)(HSM*, int, void*);
} HSM_STATE;

// 示例处理器函数
void stateA_handler(HSM* _This, int event, void* param) {
    switch (event) {
        case HSME_ENTRY:
            std::cout << "State A handles ENTRY\n";
            break;
        case HSME_INIT:
            std::cout << "State A handles INIT\n";
            break;
        default:
            std::cout << "State A does not handle this event\n";
            break;
    }
}

// 示例状态机初始化
void HSM_Create(HSM _This, const char* name, HSM_STATE *initState)
{
    This->curState = initState;
    std::cout << "Initializing state: " << This->curState->name << "\n";
    This->curState->handler(This, HSME_ENTRY, 0);
    This->curState->handler(This, HSME_INIT, 0);
}

int main() {
    HSM myHSM;
    HSM_STATE stateA = {"State A", NULL, stateA_handler};

    // 初始化状态机
    HSM_Create(&myHSM, "MyHSM", &stateA);

    return 0;
}

输出

Initializing state: State A
State A handles ENTRY
State A handles INIT

详细步骤解析

1. 定义状态和处理器函数:

   • 定义了一个简单的状态 State A，其处理器函数为 stateA_handler。
   • 处理器函数根据传入的事件类型执行相应的操作：
     • 当接收到 HSME_ENTRY 事件时，打印 “State A handles ENTRY”。
     • 当接收到 HSME_INIT 事件时，打印 “State A handles INIT”。

2. 初始化状态机:

   • 调用 HSM_Create(&myHSM, "MyHSM", &stateA);
   • 在 HSM_Create 函数中：
     • 将 myHSM 的当前状态设置为 &stateA。
     • 打印初始化信息：Initializing state: State A
     • 调用 stateA_handler(&myHSM, HSME_ENTRY, 0);，打印 “State A handles ENTRY”
     • 再次调用 stateA_handler(&myHSM, HSME_INIT, 0);，打印 “State A handles INIT”

总结

• 初始化状态: 将状态机的当前状态设置为传入的初始状态。
• 进入事件处理: 调用当前状态的处理器函数来处理 HSME_ENTRY 事件，执行状态进入时的操作。
• 初始化事件处理: 再次调用当前状态的处理器函数来处理 HSME_INIT 事件，执行更详细的初始化操作。

通过这种方式，状态机在创建时能够正确地设置初始状态，并执行必要的进入和初始化操作。这为后续的状态转换和事件处理奠定了基础。