Rust BufRead.read_line用法及代碼示例

本文簡要介紹rust語言中 std::io::BufRead.read_line 的用法。

用法

fn read_line(&mut self, buf: &mut String) -> Result<usize>

讀取所有字節，直到到達換行符(0xA 字節)，並將它們附加到提供的緩衝區。

此函數將從底層流中讀取字節，直到找到換行符分隔符(0xA 字節)或 EOF。一旦找到，所有字節(包括分隔符)(如果找到)都將附加到 buf 。

如果成功，此函數將返回讀取的總字節數。

如果此函數返回 Ok(0) ，則流已達到 EOF。

此函數是阻塞的，應謹慎使用：攻擊者有可能連續發送字節而不發送換行符或 EOF。

錯誤

此函數具有與 read_until 相同的錯誤語義，並且如果讀取的字節不是有效的 UTF-8，也會返回錯誤。如果遇到 I/O 錯誤，那麽 buf 可能包含一些已經讀取的字節，前提是到目前為止讀取的所有數據都是有效的 UTF-8。

例子

std::io::Cursor 是一種實現 BufRead 的類型。在此示例中，我們使用 Cursor 來讀取字節切片中的所有行：

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

let mut cursor = io::Cursor::new(b"foo\nbar");
let mut buf = String::new();

// cursor is at 'f'
let num_bytes = cursor.read_line(&mut buf)
    .expect("reading from cursor won't fail");
assert_eq!(num_bytes, 4);
assert_eq!(buf, "foo\n");
buf.clear();

// cursor is at 'b'
let num_bytes = cursor.read_line(&mut buf)
    .expect("reading from cursor won't fail");
assert_eq!(num_bytes, 3);
assert_eq!(buf, "bar");
buf.clear();

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

相關用法

注：本文由純淨天空篩選整理自rust-lang.org大神的英文原創作品 std::io::BufRead.read_line。非經特殊聲明，原始代碼版權歸原作者所有，本譯文未經允許或授權，請勿轉載或複製。