# * coding: UTF8 *
"""
poll类,调用uselect.poll()后返回的示例
|
"""
[文档]def register(obj, eventmask):
"""
在轮询对象中注册 ``stream`` 目标用来轮询。
eventmask 是可选的位掩码,用于指定要检查的事件类型, 默认值是 uselect.POLLIN | uselect.POLLOUT。
* uselect.POLLIN - 可供读取的数据
* uselect.POLLOUT - 更多可供写入的数据
.. admonition:: 注意
:class: note
诸如uselect.POLLHUP和uselect.POLLERR之类的标志不能作为输入事件掩码使用(这些是未经请求的事件,无论是否要求,它们都会从poll() 返回), 此语义是根据POSIX定义的。
可以为同一obj多次调用此函数,连续调用会将obj的事件掩码更新为事件掩码的值。
"""
pass
[文档]def unregister(obj):
"""
从轮询中注销obj
"""
pass
[文档]def modify(obj, eventmask):
"""
修改obj的事件掩码。如果未注册obj,则会引发OSError并出现ENOENT错误。
"""
pass
[文档]def poll(timeout):
"""
等待至少一个已注册的对象准备就绪或处于异常状态,并带有以毫秒为单位的可选超时(如果未指定timeout参数或指定为-1,则持续等待)。
返回(obj,event,…)元组的列表, 元组中可能还有其他元素,具体取决于平台和版本,因此不要假定其大小为2。
event元素指定流中发生了哪些事件,并且是上述uselect.POLLIN / uselect.POLLOUT 常量的组合。
.. admonition:: 注意
:class: note
标记uselect.POLLHUP和uselect.POLLERR可以在任何时候返回(即使未要求), 并且必须相应地对其进行操作(相应的流已从poll中注销,并且可能已关闭),
因为否则将进一步调用poll() 可能会立即返回,并再次为此流设置这些标志。
如果超时,则返回一个空列表。
"""
pass
[文档]def ipoll(timeout):
"""
与poll.poll()类似,但是返回一个迭代器,该迭代器生成被调用方拥有的元组。此功能提供了一种高效,无需分配的方式来轮询流。
如果标志为1,则采用事件的一次性行为:发生事件的流将自动重置其事件掩码(相当于poll.modify(obj,0)),
因此不会为该流添加新事件进行处理,直到使用poll.modify()设置了新的蒙版为止。
此行为对于异步I/O调度程序很有用。
"""
pass