Asio Streams, Short Reads and Short Writes

Asio中的许多I/O对象都是面向流的。这意味着：

• 没有消息边界。正在传输的数据是一个连续的字节序列。
• 读取或写入操作传输的字节数可能少于请求的字节数。这称为短读或短写。

提供面向流的 I/O 的对象模拟以下一种或多种类型要求：

• SyncReadStream，其中同步读取操作是使用成员函数read_some()执行的 。
• AsyncReadStream，其中异步读取操作是使用成员函数async_read_some()执行的。
• SyncWriteStream，其中同步写入操作是使用成员函数write_some()执行的。
• AsyncWriteStream，其中异步写入操作是使用成员函数async_write_some()执行的。

面向流的 I/O 对象的示例包括 ip::tcp::socket，ssl::stream<>，posix::stream_descriptor，windows::stream_handle等。

程序通常希望传输确定数量的字节。当发生短读或短写时，程序必须重新开始操作，并继续直到传输所需的字节数。Asio 提供了自动执行此操作的通用函数read()，async_read()，write()和async_write()。

Why EOF is an Error

流的结束可能导致read、 async_read、read_until或async_read_until函数违反它们的规则。例如，由于 EOF，读取N 字节可能会提前完成。
EOF错误可用于区分流的结束与大小为 0 的成功读取。

原文