普贤教程 › 包参考

eventloop 包

事件循环（同步模拟）

项	值
包名	`eventloop`
版本	`0.2.0`
可用版本	`0.1.0 / 0.2.0`
入口	`eventloop.px`
分类	`并发与通用模式`
文件数 / 行数	`1 / 125`

安装与引入

bash

pxpkg init          # 首次
pxpkg add eventloop@0.2.0
pxpkg install

import eventloop

所属分类教程：并发与通用模式

公开接口

函数	参数
`el_new`
`el_clear`	`loop`
`el_tasks`	`loop`
`el_tick_count`	`loop`
`el_add_task`	`loop, callback, arg = null`
`el_add_timer`	`loop, callback, delay, arg = null`
`el_add_repeat`	`loop, callback, interval, arg = null`
`el_cancel`	`loop, task_id`
`el_tick`	`loop`
`el_run`	`loop`
`el_pending_count`	`loop`

其余 1 个 def（内部与辅助，可直接调用但不属稳定接口）

函数	参数
`_el_add`	`loop, callback, arg, delay, repeat, interval`

包内说明（源码头注释）

text

============================================================
普贤生态库：registry/eventloop — 事件循环（同步模拟）
------------------------------------------------------------
纯函数库，双模式一致。

实现要点：
- el_add_timer(loop, fn, delay, arg = null)：arg 可传，三参调用行为不变。
- el_add_repeat(loop, fn, interval, arg = null)：周期定时器，每次触发后自动重挂。
- el_tick() 保留「快照期间新加的任务」，不再丢。
- 新增 el_clear(loop) / el_tasks(loop) / el_tick_count(loop)。

函数：
el_new() / el_clear(loop) / el_tasks(loop) / el_tick_count(loop)
el_add_task(loop, fn, arg)              → task id
el_add_timer(loop, fn, delay, arg = null) → task id
el_add_repeat(loop, fn, interval, arg = null) → task id
el_cancel(loop, task_id) → bool
el_tick(loop) → int（本轮处理的事件数）
el_run(loop)  → int（累计处理数）
el_pending_count(loop) → int
============================================================