当前位置: 首页>>代码示例 >>用法及示例精选 >>正文


Rust BufRead.read_until用法及代码示例


本文简要介绍rust语言中 std::io::BufRead.read_until 的用法。

用法

fn read_until(&mut self, byte: u8, buf: &mut Vec<u8>) -> Result<usize>

将所有字节读入buf,直到到达分隔符byte 或EOF。

此函数将从底层流中读取字节,直到找到分隔符或 EOF。一旦找到,所有字节(包括分隔符)(如果找到)都将附加到 buf

如果成功,此函数将返回读取的总字节数。

此函数是阻塞的,应谨慎使用:攻击者有可能连续发送字节而不发送分隔符或 EOF。

错误

此函数将忽略 ErrorKind::Interrupted 的所有实例,否则将返回 fill_buf 返回的任何错误。

如果遇到 I/O 错误,那么到目前为止读取的所有字节都将存在于 buf 中,并且其长度将被适当调整。

例子

std::io::Cursor 是一种实现 BufRead 的类型。在此示例中,我们使用 Cursor 来读取连字符分隔段中字节切片中的所有字节:

use std::io::{self, BufRead};

let mut cursor = io::Cursor::new(b"lorem-ipsum");
let mut buf = vec![];

// cursor is at 'l'
let num_bytes = cursor.read_until(b'-', &mut buf)
    .expect("reading from cursor won't fail");
assert_eq!(num_bytes, 6);
assert_eq!(buf, b"lorem-");
buf.clear();

// cursor is at 'i'
let num_bytes = cursor.read_until(b'-', &mut buf)
    .expect("reading from cursor won't fail");
assert_eq!(num_bytes, 5);
assert_eq!(buf, b"ipsum");
buf.clear();

// cursor is at EOF
let num_bytes = cursor.read_until(b'-', &mut buf)
    .expect("reading from cursor won't fail");
assert_eq!(num_bytes, 0);
assert_eq!(buf, b"");

相关用法


注:本文由纯净天空筛选整理自rust-lang.org大神的英文原创作品 std::io::BufRead.read_until。非经特殊声明,原始代码版权归原作者所有,本译文未经允许或授权,请勿转载或复制。