## timer\_manager\_t ### 概述 定时器管理器。 ---------------------------------- ### 函数
| 函数名称 | 说明 | | -------- | ------------ | | timer\_manager | 获取缺省的定时器管理器。 | | timer\_manager\_add | 添加定时器。 | | timer\_manager\_all\_remove\_by\_ctx | 根据上下文删除所有对应的定时器。 | | timer\_manager\_append | 追加定时器。 | | timer\_manager\_count | 返回定时器的个数。 | | timer\_manager\_create | 创建定时器管理器。 | | timer\_manager\_deinit | 析构定时器管理器。 | | timer\_manager\_destroy | 析构并释放定时器管理器。 | | timer\_manager\_dispatch | 检查全部定时器的函数,如果时间到期,调用相应的timer函数。 | | timer\_manager\_find | 查找指定ID的定时器。 | | timer\_manager\_init | 初始化定时器管理器。 | | timer\_manager\_next\_time | 返回最近的定时器到期时间。 | | timer\_manager\_remove | 根据id删除定时器。 | | timer\_manager\_reset | 重置定时器。 | | timer\_manager\_set | 设置缺省的定时器管理器。 | #### timer\_manager 函数 ----------------------- * 函数功能: >
获取缺省的定时器管理器。 * 函数原型: ``` timer_manager_t* timer_manager (); ``` * 参数说明: | 参数 | 类型 | 说明 | | -------- | ----- | --------- | | 返回值 | timer\_manager\_t* | 返回定时器管理器对象。 | #### timer\_manager\_add 函数 ----------------------- * 函数功能: >
添加定时器。 * 函数原型: ``` uint32_t timer_manager_add (timer_manager_t* timer_manager, timer_func_t* on_timer, void* ctx, uint32_t duration); ``` * 参数说明: | 参数 | 类型 | 说明 | | -------- | ----- | --------- | | 返回值 | uint32\_t | 返回timer的ID,TK\_INVALID\_ID表示失败。 | | timer\_manager | timer\_manager\_t* | 定时器管理器对象。 | | on\_timer | timer\_func\_t* | timer回调函数。 | | ctx | void* | timer回调函数的上下文。 | | duration | uint32\_t | 时间。 | #### timer\_manager\_all\_remove\_by\_ctx 函数 ----------------------- * 函数功能: >
根据上下文删除所有对应的定时器。 * 函数原型: ``` ret_t timer_manager_all_remove_by_ctx (timer_manager_t* timer_manager, void* ctx); ``` * 参数说明: | 参数 | 类型 | 说明 | | -------- | ----- | --------- | | 返回值 | ret\_t | 返回RET\_OK表示成功,否则表示失败。 | | timer\_manager | timer\_manager\_t* | 定时器管理器对象。 | | ctx | void* | timer回调函数的上下文。 | #### timer\_manager\_append 函数 ----------------------- * 函数功能: >
追加定时器。 * 函数原型: ``` ret_t timer_manager_append (timer_manager_t* timer_manager, timer_info_t* timer); ``` * 参数说明: | 参数 | 类型 | 说明 | | -------- | ----- | --------- | | 返回值 | ret\_t | 返回RET\_OK表示成功,否则表示失败。 | | timer\_manager | timer\_manager\_t* | 定时器管理器对象。。 | | timer | timer\_info\_t* | timer对象。 | #### timer\_manager\_count 函数 ----------------------- * 函数功能: >
返回定时器的个数。 * 函数原型: ``` uint32_t timer_manager_count (timer_manager_t* timer_manager); ``` * 参数说明: | 参数 | 类型 | 说明 | | -------- | ----- | --------- | | 返回值 | uint32\_t | 返回timer的个数。 | | timer\_manager | timer\_manager\_t* | 定时器管理器对象。 | #### timer\_manager\_create 函数 ----------------------- * 函数功能: >
创建定时器管理器。 * 函数原型: ``` timer_manager_t* timer_manager_create (timer_get_time_t get_time); ``` * 参数说明: | 参数 | 类型 | 说明 | | -------- | ----- | --------- | | 返回值 | timer\_manager\_t* | 返回定时器管理器对象。 | | get\_time | timer\_get\_time\_t | 获取当前时间的函数。 | #### timer\_manager\_deinit 函数 ----------------------- * 函数功能: >
析构定时器管理器。 * 函数原型: ``` ret_t timer_manager_deinit (timer_manager_t* timer_manager); ``` * 参数说明: | 参数 | 类型 | 说明 | | -------- | ----- | --------- | | 返回值 | ret\_t | 返回RET\_OK表示成功,否则表示失败。 | | timer\_manager | timer\_manager\_t* | 定时器管理器对象。 | #### timer\_manager\_destroy 函数 ----------------------- * 函数功能: >
析构并释放定时器管理器。 * 函数原型: ``` ret_t timer_manager_destroy (timer_manager_t* timer_manager); ``` * 参数说明: | 参数 | 类型 | 说明 | | -------- | ----- | --------- | | 返回值 | ret\_t | 返回RET\_OK表示成功,否则表示失败。 | | timer\_manager | timer\_manager\_t* | 定时器管理器对象。 | #### timer\_manager\_dispatch 函数 ----------------------- * 函数功能: >
检查全部定时器的函数,如果时间到期,调用相应的timer函数。 * 函数原型: ``` ret_t timer_manager_dispatch (); ``` * 参数说明: | 参数 | 类型 | 说明 | | -------- | ----- | --------- | | 返回值 | ret\_t | 返回RET\_OK表示成功,否则表示失败。 | #### timer\_manager\_find 函数 ----------------------- * 函数功能: >
查找指定ID的定时器。 * 函数原型: ``` timer_info_t* timer_manager_find (timer_manager_t* timer_manager, uint32_t timer_id); ``` * 参数说明: | 参数 | 类型 | 说明 | | -------- | ----- | --------- | | 返回值 | timer\_info\_t* | 返回timer的信息。 | | timer\_manager | timer\_manager\_t* | 定时器管理器对象。 | | timer\_id | uint32\_t | timer\_id | #### timer\_manager\_init 函数 ----------------------- * 函数功能: >
初始化定时器管理器。 * 函数原型: ``` timer_manager_t* timer_manager_init (timer_manager_t* timer_manager, timer_get_time_t get_time); ``` * 参数说明: | 参数 | 类型 | 说明 | | -------- | ----- | --------- | | 返回值 | timer\_manager\_t* | 返回定时器管理器对象。 | | timer\_manager | timer\_manager\_t* | 定时器管理器对象。 | | get\_time | timer\_get\_time\_t | 获取当前时间的函数。 | #### timer\_manager\_next\_time 函数 ----------------------- * 函数功能: >
返回最近的定时器到期时间。 * 函数原型: ``` uint64_t timer_manager_next_time (timer_manager_t* timer_manager); ``` * 参数说明: | 参数 | 类型 | 说明 | | -------- | ----- | --------- | | 返回值 | uint64\_t | 返回最近的timer到期时间。 | | timer\_manager | timer\_manager\_t* | 定时器管理器对象。 | #### timer\_manager\_remove 函数 ----------------------- * 函数功能: >
根据id删除定时器。 * 函数原型: ``` ret_t timer_manager_remove (timer_manager_t* timer_manager, uint32_t timer_id); ``` * 参数说明: | 参数 | 类型 | 说明 | | -------- | ----- | --------- | | 返回值 | ret\_t | 返回RET\_OK表示成功,否则表示失败。 | | timer\_manager | timer\_manager\_t* | 定时器管理器对象。 | | timer\_id | uint32\_t | timer\_id。 | #### timer\_manager\_reset 函数 ----------------------- * 函数功能: >
重置定时器。 * 函数原型: ``` ret_t timer_manager_reset (timer_manager_t* timer_manager, uint32_t* timer_id); ``` * 参数说明: | 参数 | 类型 | 说明 | | -------- | ----- | --------- | | 返回值 | ret\_t | 返回RET\_OK表示成功,否则表示失败。 | | timer\_manager | timer\_manager\_t* | 定时器管理器对象。 | | timer\_id | uint32\_t* | timer\_id。 | #### timer\_manager\_set 函数 ----------------------- * 函数功能: >
设置缺省的定时器管理器。 * 函数原型: ``` ret_t timer_manager_set (timer_manager_t* timer_manager_t); ``` * 参数说明: | 参数 | 类型 | 说明 | | -------- | ----- | --------- | | 返回值 | ret\_t | 返回RET\_OK表示成功,否则表示失败。 | | timer\_manager\_t | timer\_manager\_t* | 定时器管理器对象。 |