低层级 API 索引
本页列出所有低层级的 asyncio API。
获取事件循环
获取当前运行的事件循环 首选 函数。 | |
获得一个事件循环实例(当前或通过策略)。 | |
通过当前策略将事件循环设置当前事件循环。 | |
创建一个新的事件循环。 |
例子
事件循环方法集
See also the main documentation section about the 事件循环方法集.
生命周期
运行一个期程/任务/可等待对象直到完成。 | |
一直运行事件循环。 | |
停止事件循环。 | |
关闭事件循环。 | |
返回 | |
返回 | |
关闭异步生成器。 |
调试
开启或禁用调试模式。 | |
获取当前测试模式。 |
调度回调函数
尽快调用回调。 | |
loop.call_soon() 方法线程安全的变体。 | |
在给定时间 之后 调用回调函数。 | |
在 指定 时间调用回调函数。 |
线程/进程池
| 在 concurrent.futures 执行器中运行一个独占CPU或其它阻塞函数。 |
设置 loop.run_in_executor() 默认执行器。 |
任务与期程
创建一个 Future 对象。 | |
将协程当作 Task 一样调度。 | |
设置 loop.create_task() 使用的工厂,它将用来创建 Tasks 。 | |
获取 loop.create_task() 使用的工厂,它用来创建 Tasks 。 |
DNS
| 异步版的 socket.getaddrinfo() 。 |
| 异步版的 socket.getnameinfo() 。 |
网络和IPC
| 打开一个TCP链接。 |
| 创建一个TCP服务。 |
打开一个Unix socket连接。 | |
创建一个Unix socket服务。 | |
将 socket 包装成 | |
打开一个数据报(UDP)连接。 | |
| 通过传输通道发送一个文件。 |
| 将一个已建立的链接升级到TLS。 |
| 将管道读取端包装成 |
将管道写入端包装成 |
套接字
| 从 socket 接收数据。 |
| 从 socket 接收数据到一个缓冲区中。 |
| Receive a datagram from the socket. |
Receive a datagram from the socket into a buffer. | |
| 发送数据到 socket 。 |
| Send a datagram via the socket to the given address. |
| 链接 |
| 接受一个 socket 链接。 |
| 利用 socket 发送一个文件。 |
开始对一个文件描述符的可读性的监视。 | |
停止对一个文件描述符的可读性的监视。 | |
开始对一个文件描述符的可写性的监视。 | |
停止对一个文件描述符的可写性的监视。 |
Unix信号
给 signal 添加一个处理回调函数。 | |
删除 signal 的处理回调函数。 |
子进程集
衍生一个子进程 | |
从终端命令衍生一个子进程。 |
错误处理
调用异常处理器。 | |
设置一个新的异常处理器。 | |
获取当前异常处理器。 | |
默认异常处理器实现。 |
例子
传输
所有传输都实现以下方法:
关闭传输。 | |
返回 | |
请求传输的相关信息。 | |
设置一个新协议。 | |
返回当前协议。 |
传输可以接收数据(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() 等方法返回。
写入传输
向传输写入数据。 | |
向传输写入缓冲。 | |
返回 True ,如果传输支持发送 EOF。 | |
在冲洗已缓冲的数据后关闭传输和发送EOF。 | |
立即关闭传输。 | |
Return the current size of the output buffer. | |
返回写入流控制的高位标记位和低位标记位。 | |
设置新的写入流控制的高位标记位和低位标记位。 |
由 loop.create_datagram_endpoint() 返回的传输:
数据报传输
发送数据到远程链接端。 | |
立即关闭传输。 |
基于子进程的底层抽象传输,它由 loop.subprocess_exec() 和 loop.subprocess_shell() 返回:
子进程传输
返回子进程的进程ID。 | |
返回请求通信管道 (stdin, stdout, 或 stderr)的传输。 | |
返回子进程的返回代号。 | |
杀死子进程。 | |
发送一个信号到子进程。 | |
停止子进程。 | |
杀死子进程并关闭所有管道。 |
协议
协议类可以由下面 回调方法 实现:
| 连接建立时被调用。 |
| 连接丢失或关闭时将被调用。 |
| 传输的缓冲区超过高位标记位时被调用。 |
| 传输的缓冲区传送到低位标记位时被调用。 |
流协议 (TCP, Unix 套接字, 管道)
| 接收到数据时被调用。 |
| 接收到EOF时被调用。 |
缓冲流协议
| 调用后会分配新的接收缓冲区。 |
| 用接收的数据更新缓冲区时被调用。 |
| 接收到EOF时被调用。 |
数据报协议
| 接收到数据报时被调用。 |
| 前一个发送或接收操作引发 OSError 时被调用。 |
子进程协议
| 子进程向 stdout 或 stderr 管道写入数据时被调用。 |
| 与子进程通信的其中一个管道关闭时被调用。 |
| 子进程退出时被调用。 |
事件循环策略
策略是改变 asyncio.get_event_loop() 这类函数行为的一个底层机制。更多细节可以查阅 策略部分。
访问策略
返回当前进程域的策略。 | |
设置一个新的进程域策略。 | |
策略对象的基类。 |