低层级 API 索引¶
本页列出所有低层级的 asyncio API。
获取事件循环¶
获取当前运行的事件循环 首选 函数。 |
|
获取一个事件循环实例(正在运行的事件循环或通过当前策略确定的当前事件循环)。 |
|
通过当前策略将事件循环设置当前事件循环。 |
|
创建一个新的事件循环。 |
例子
事件循环方法集¶
另请参阅有关 事件循环方法集 的主文档章节。
生命周期
运行一个期程/任务/可等待对象直到完成。 |
|
一直运行事件循环。 |
|
停止事件循环。 |
|
关闭事件循环。 |
|
返回 |
|
返回 |
|
关闭异步生成器。 |
调试
开启或禁用调试模式。 |
|
获取当前测试模式。 |
调度回调函数
尽快调用回调。 |
|
|
|
在给定时间 之后 调用回调函数。 |
|
在 指定 时间调用回调函数。 |
线程/进程池
|
在 |
设置 |
任务与期程
创建一个 |
|
将协程当作 |
|
设置 |
|
获取 |
DNS
|
异步版的 |
|
异步版的 |
网络和IPC
|
打开一个TCP链接。 |
|
创建一个TCP服务。 |
打开一个Unix socket连接。 |
|
创建一个Unix socket服务。 |
|
将 |
|
打开一个数据报(UDP)连接。 |
|
|
通过传输通道发送一个文件。 |
|
将一个已建立的链接升级到TLS。 |
|
将管道读取端包装成 |
将管道写入端包装成 |
套接字
|
从 |
|
从 |
|
从 |
从 |
|
|
发送数据到 |
|
通过 |
|
链接 |
|
接受一个 |
|
利用 |
开始对一个文件描述符的可读性的监视。 |
|
停止对一个文件描述符的可读性的监视。 |
|
开始对一个文件描述符的可写性的监视。 |
|
停止对一个文件描述符的可写性的监视。 |
Unix信号
给 |
|
删除 |
子进程集
衍生一个子进程 |
|
从终端命令衍生一个子进程。 |
错误处理
调用异常处理器。 |
|
设置一个新的异常处理器。 |
|
获取当前异常处理器。 |
|
默认异常处理器实现。 |
例子
传输¶
所有传输都实现以下方法:
关闭传输。 |
|
返回 |
|
请求传输的相关信息。 |
|
设置一个新协议。 |
|
返回当前协议。 |
传输可以接收数据(TCP和Unix链接,管道等)。它通过 loop.create_connection()
, loop.create_unix_connection()
, loop.connect_read_pipe()
等方法返回。
读取传输
返回 |
|
暂停接收。 |
|
继续接收。 |
传输可以发送数据(TCP和Unix链接,管道等)。它通过 loop.create_connection()
, loop.create_unix_connection()
, loop.connect_write_pipe()
等方法返回。
写入传输
向传输写入数据。 |
|
向传输写入缓冲。 |
|
返回 |
|
在冲洗已缓冲的数据后关闭传输和发送EOF。 |
|
立即关闭传输。 |
|
返回当前输出缓冲区的大小。 |
|
返回写入流控制的高位标记位和低位标记位。 |
|
设置新的写入流控制的高位标记位和低位标记位。 |
由 loop.create_datagram_endpoint()
返回的传输:
数据报传输
发送数据到远程链接端。 |
|
立即关闭传输。 |
基于子进程的底层抽象传输,它由 loop.subprocess_exec()
和 loop.subprocess_shell()
返回:
子进程传输
返回子进程的进程ID。 |
|
返回请求通信管道 (stdin, stdout, 或 stderr)的传输。 |
|
返回子进程的返回代号。 |
|
杀死子进程。 |
|
发送一个信号到子进程。 |
|
停止子进程。 |
|
杀死子进程并关闭所有管道。 |
协议¶
协议类可以由下面 回调方法 实现:
|
连接建立时被调用。 |
|
连接丢失或关闭时将被调用。 |
|
传输的缓冲区超过高位标记位时被调用。 |
|
传输的缓冲区传送到低位标记位时被调用。 |
流协议 (TCP, Unix 套接字, 管道)
|
接收到数据时被调用。 |
|
接收到EOF时被调用。 |
缓冲流协议
|
调用后会分配新的接收缓冲区。 |
|
用接收的数据更新缓冲区时被调用。 |
|
接收到EOF时被调用。 |
数据报协议
|
接收到数据报时被调用。 |
|
前一个发送或接收操作引发 |
子进程协议
|
子进程向 stdout 或 stderr 管道写入数据时被调用。 |
|
与子进程通信的其中一个管道关闭时被调用。 |
|
当子进程退出时被调用。 可在 |
事件循环策略¶
策略是改变 asyncio.get_event_loop()
这类函数行为的一个底层机制。更多细节可以查阅 策略部分。
访问策略
返回当前进程域的策略。 |
|
设置一个新的进程域策略。 |
|
策略对象的基类。 |