示例

extern crate linereader;
use linereader::LineReader;

let mut file = File::open(myfile).expect("open");

// Defaults to a 64 KiB buffer and b'\n' delimiter; change with one of:
//  * LineReader::with_capacity(usize);
//  * LineReader::with_delimiter(u8);
//  * LineReader::with_delimiter_and_capacity(u8, usize)
let mut reader = LineReader::new(file);

while let Some(line) = reader.next_line() {
    let line = line.expect("read error");
    // line is a &[u8] owned by reader.
}

安全性

LineReader 不包含 unsafe 代码，但它确实会手动分发来自内部缓冲区的手动计算的切片位置，而 Rust 执行的唯一强制措施是确保它们保持在缓冲区内部。

没有不完整的行检测，根据文档，超出配置缓冲区的行可以分布在多个“行”中，只有缺少终止符作为提示。应该注意，这不会导致使用库的代码中出现不期望的行为。

如get_mut()等方法提供了对封装的读取器的直接访问，如果没有同时调用reset()，如果读取器的状态发生改变，可能会出现不期望的行为。

替代方案

bstr：从0.2.8版本开始，for_byte_line和for_byte_line_with_terminator BufRead扩展特质函数应该具有类似的功能，没有LineReader的行长度限制。

性能

使用'Dickens_Charles_Pickwick_Papers.xml'进行的测试，将其自身连接480次。生成的文件大小为976 MB，有1030万行。

Westmere Xeon 2.1GHz，FreeBSD/ZFS。