Rust / 系统课时

使用缓冲读取

使用缓冲读取

直接对异步流反复做小块读取,会让业务代码频繁处理边界与分隔符。BufReader 在底层流之上维护缓冲区,让 read_line、read_until 等接口按协议边界取数据,同时保留已经预读但尚未消费的字节。

学习目标

  • 使用 BufReader 包装 Tokio 异步读取端,并调用 read_line 与 read_until
  • 理解“已预读到缓冲区”与“底层流尚未读取”之间的状态关系
  • 避免绕过缓冲器直接读取底层流造成数据顺序混乱或丢失

缓冲读取解决什么问题

BufReader<R> 包装一个实现 AsyncRead 的读取源。调用者只需要按行或按分隔符消费数据;当内部缓冲区不够时,BufReader 才继续从底层流读取。一次底层读取可能取得超过当前边界的数据,多出来的部分会留在缓冲区,供下一次读取继续使用。

BufReader 缓冲区与底层流的读取关系

这意味着“底层流当前位置”不等于“业务代码已经消费的位置”。只要 BufReader 仍持有未消费字节,就应该继续通过同一个缓冲器读取。

按行和按分隔符读取

示例使用 tokio::io::duplex 构造一对内存异步流,不依赖真实网络。在已添加 Tokio 1.x 且启用 full 特性的 Cargo 项目中可直接运行。

rust
use tokio::io::{
    self, AsyncBufReadExt, AsyncReadExt, AsyncWriteExt, BufReader,
};

#[tokio::main]
async fn main() -> io::Result<()> {
    let (client, mut server) = tokio::io::duplex(64);

    // 写入三段数据,并关闭写端表示后续不会再有字节。
    server.write_all(b"alpha\nbeta|tail").await?;
    server.shutdown().await?;

    let mut reader = BufReader::new(client);

    let mut line = String::new();
    reader.read_line(&mut line).await?;
    print!("line={line}");

    let mut chunk = Vec::new();
    reader.read_until(b'|', &mut chunk).await?;
    println!("chunk={}", String::from_utf8_lossy(&chunk));

    // 继续从同一个 BufReader 读取,先消费其中已缓冲的剩余数据。
    let mut tail = String::new();
    reader.read_to_string(&mut tail).await?;
    println!("tail={tail}");

    Ok(())
}

预期输出

text
line=alpha
chunk=beta|
tail=tail

read_line 会把读取到的内容追加到传入的 String,遇到换行符时返回,并保留该换行符;read_until 会把字节追加到 Vec<u8>,直到包含指定分隔字节。两者返回值都是本次追加的字节数。

选择接口时注意边界

如果协议明确是 UTF-8 文本行,read_line 最直接;如果边界是单个字节,或数据不保证是 UTF-8,优先使用 read_until。重复调用前还要决定是清空目标缓冲区,还是有意继续追加。

需要取回底层流时可调用 into_inner,但尚未被消费的内部缓冲数据不会自动交还给底层流。若这些字节仍然重要,应先通过 BufReader 把它们处理完,再改变读取方式。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用缓冲读取

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通