本文简要介绍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 BufRead.read_until用法及代码示例
- Rust BufRead.split用法及代码示例
- Rust BufRead.fill_buf用法及代码示例
- Rust BufRead.has_data_left用法及代码示例
- Rust BufRead.lines用法及代码示例
- Rust BufReader.new用法及代码示例
- Rust BufReader.get_mut用法及代码示例
- Rust BufReader.with_capacity用法及代码示例
- Rust BufReader.capacity用法及代码示例
- Rust BufReader.buffer用法及代码示例
- Rust BufRead用法及代码示例
- Rust BufReader用法及代码示例
- Rust BufReader.get_ref用法及代码示例
- Rust BufReader.into_inner用法及代码示例
- Rust BufWriter.capacity用法及代码示例
- Rust BufWriter.get_ref用法及代码示例
- Rust BufWriter.get_mut用法及代码示例
- Rust BufWriter.into_inner用法及代码示例
- Rust BufWriter用法及代码示例
- Rust BufWriter.with_capacity用法及代码示例
- Rust BufWriter.new用法及代码示例
- Rust BufWriter.into_parts用法及代码示例
- Rust BufWriter.buffer用法及代码示例
- Rust Builder.stack_size用法及代码示例
- Rust BuildHasher.build_hasher用法及代码示例
注:本文由纯净天空筛选整理自rust-lang.org大神的英文原创作品 std::io::BufRead.read_line。非经特殊声明,原始代码版权归原作者所有,本译文未经允许或授权,请勿转载或复制。