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。非經特殊聲明，原始代碼版權歸原作者所有，本譯文未經允許或授權，請勿轉載或複製。