Class selsp
XWLUA类：信号选择器对象强指针
信号选择器对象强指针是Lua语言中的一种 userdata ，用于 强引用 XWOS的信号选择器对象。
强引用 表示会增加XWOS的信号选择器对象的 引用计数 。
MetaMethods
| selsp:metatable.__copy (selsp, vm) | 元方法：__copy |
| selsp:metatable.__gc (selsp) | 元方法：__gc |
| selsp:metatable.__tostring (selsp) | 元方法：__tostring |
Methods
| selsp:bind (selsp, dst, pos) | 绑定 源 信号选择器对象到 目的 信号选择器 |
| selsp:unbind (selsp, dst) | 从 目的 信号选择器上解绑 源 信号选择器对象 |
| selsp:bmp (selsp) | 新建位图，位的数量与信号选择器中的信号槽数量相等 |
| selsp:num (selsp) | 获取信号选择器中信号槽（位）的数量 |
| selsp:select (selsp, msk) | 等待信号选择器中的触发信号 |
| selsp:tryselect (selsp, msk) | 检测信号选择器中是否有同步信号触发 |
| selsp:select_to (selsp, msk, to) | 限时等待信号选择器中的同步信号 |
MetaMethods
- selsp:metatable.__copy (selsp, vm)
-
元方法：__copy
将信号选择器对象强指针拷贝到全局导出表 xwxt 中。
此元方法意味着信号选择器对象的强引用多了一个， 引用计数 加 1 。
Parameters:
- selsp userdata (in) 信号选择器对象强指针
- vm userdata (in) 目标虚拟机
Usage:
selsp = ... -- 创建信号选择器的代码（省略） xwxt.somesel = selsp -- 信号选择器对象的引用计数加1 selsp2 = xwxt.somesel -- 信号选择器对象的引用计数加1 xwxt.somesel = nil -- 信号选择器对象的引用计数减1
- selsp:metatable.__gc (selsp)
-
元方法：__gc
信号选择器对象强指针的垃圾回收方法。
此元方法意味着信号选择器对象的强引用少了一个， 引用计数 减 1 。
Parameters:
- selsp userdata (in) 信号选择器对象强指针
Usage:
selsp = nil -- 删除引用 collectgarbage() -- 强制垃圾回收，将调用__gc()函数
- selsp:metatable.__tostring (selsp)
-
元方法：__tostring
将信号选择器对象强指针格式化成字符串，可用于终端打印调试。
Parameters:
- selsp userdata (in) 信号选择器对象强指针
Usage:
print(selsp)
Methods
- selsp:bind (selsp, dst, pos)
-
绑定 源 信号选择器对象到 目的 信号选择器
Parameters:
- selsp userdata (in) 源 信号选择器对象强指针
- dst userdata (in) 目的 信号选择器对象的强指针
- pos number (in) 信号选择器对象映射到目的信号选择器位图中的位置，位置从 0 开始编号
Returns:
-
number
错误码
● 0 没有错误
● -ECHRNG 位置超出范围
● -EALREADY 同步对象已经绑定到事件对象
● -EBUSY 通道已经被其他同步对象独占Usage:
sel = xwos.sel.new(32) -- ...省略... rc = sel:bind(dst, 3) -- 绑定到信号选择器的位置3 if (rc == 0) then -- 绑定成功 else -- 绑定失败 end
- selsp:unbind (selsp, dst)
-
从 目的 信号选择器上解绑 源 信号选择器对象
Parameters:
- selsp userdata (in) 源 信号选择器对象强指针
- dst userdata (in) 目的 信号选择器对象的强指针
Returns:
-
number
错误码
● 0 没有错误
● -ENOTCONN 同步对象没有绑定到事件对象上Usage:
sel:unbind(dst) - selsp:bmp (selsp)
-
新建位图，位的数量与信号选择器中的信号槽数量相等
Parameters:
- selsp userdata (in) 信号选择器对象强指针
Returns:
-
userdata
位图
Usage:
bmp = sel:bmp() - selsp:num (selsp)
-
获取信号选择器中信号槽（位）的数量
Parameters:
- selsp userdata (in) 信号选择器对象强指针
Returns:
-
number
数量
Usage:
num = sel:num() - selsp:select (selsp, msk)
-
等待信号选择器中的触发信号
Parameters:
- selsp userdata (in) 信号选择器对象强指针
- msk userdata (in) 待触发的同步对象位图掩码
Returns:
-
number
错误码
● 0 没有错误
● -EINVAL 参数错误
● -EINTR 等待被中断
● -ENOTTHDCTX 不在线程上下文中Usage:
sel = xwos.sel.new(32) -- 绑定操作... msk = sel:bmp(); msk:zero(); msk:s1i(0, 1, 2, 3, 4, 5, 6, 7) -- 掩码：0xFF rc = sel:select(msk) if (rc == 0) then -- 同步对象1,2,3,4,5,6,7,8中至少有一个触发了同步信号 else -- 错误发生 end
- selsp:tryselect (selsp, msk)
-
检测信号选择器中是否有同步信号触发
若没有同步信号触发，立即返回，不会等待。
Parameters:
- selsp userdata (in) 信号选择器对象强指针
- msk userdata (in) 待触发的同步对象位图掩码
Returns:
-
number
错误码
● 0 没有错误
● -EINVAL 参数错误
● -EINTR 等待被中断
● -ENOTTHDCTX 不在线程上下文中
● -ENODATA 尝试失败Usage:
sel = xwos.sel.new(32) -- 绑定操作... msk = sel:bmp(); msk:zero(); msk:s1i(0, 1, 2, 3, 4, 5, 6, 7) -- 掩码：0xFF rc = sel:tryselect(msk) -- 检测信号选择器中是否有同步信号触发，立即返回，不会等待 if (rc == 0) then -- 同步对象1,2,3,4,5,6,7,8中至少有一个触发了同步信号 elseif (rc == -61) -- 没有检测到 else -- 错误发生 end
- selsp:select_to (selsp, msk, to)
-
限时等待信号选择器中的同步信号
Parameters:
- selsp userdata (in) 信号选择器对象强指针
- msk userdata (in) 待触发的同步对象位图掩码
- to number (in) 期望的阻塞等待时间
Returns:
-
number
错误码
● 0 没有错误
● -EINVAL 参数错误
● -EINTR 等待被中断
● -ENOTTHDCTX 不在线程上下文中
● -ETIMEDOUT 超时Usage:
sel = xwos.sel.new(32) -- 绑定操作... msk = sel:bmp(); msk:zero(); msk:s1i(0, 1, 2, 3, 4, 5, 6, 7) -- 掩码：0xFF rc = sel:select_to(msk, xwtm.ft(xwtm.s(1))) -- 最多等待1s if (rc == 0) then -- 同步对象1,2,3,4,5,6,7,8中至少有一个触发了同步信号 elseif (rc == -116) -- 超时 else -- 错误发生 end