#data-stream #reader #buf-reader #reverse #byte-stream #nightly #adapted

rev_buf_reader

Crate that provides a buffered reader capable of reading chunks of bytes of a data stream in reverse order. Its implementation is an adapted copy of BufReader from the nightly std::io.

4 releases (2 breaking)

0.3.0 Jan 31, 2022
0.2.0 Feb 1, 2020
0.1.1 May 12, 2019
0.1.0 Mar 14, 2019

#489 in Rust patterns

Download history 2170/week @ 2024-11-30 2732/week @ 2024-12-07 2823/week @ 2024-12-14 2495/week @ 2024-12-21 1328/week @ 2024-12-28 1346/week @ 2025-01-04 2004/week @ 2025-01-11 1948/week @ 2025-01-18 379/week @ 2025-01-25 1127/week @ 2025-02-01 2110/week @ 2025-02-08 1904/week @ 2025-02-15 1550/week @ 2025-02-22 2378/week @ 2025-03-01 2415/week @ 2025-03-08 3258/week @ 2025-03-15

10,121 downloads per month
Used in 19 crates (13 directly)

Apache-2.0 OR MIT

33KB
475 lines

rev_buf_reader

GitHub Actions Workflow docs license Crates.io

This Rust crate provides a buffered reader capable of reading chunks of bytes of a data stream in reverse order. Its implementation is an adapted copy of BufReader from the nightly std::io.

Usage

Reading chunks of bytes in reverse order:

extern crate rev_buf_reader;

use rev_buf_reader::RevBufReader;
use std::io::{self, Read};

let data = [0, 1, 2, 3, 4, 5, 6, 7];
let inner = io::Cursor::new(&data);
let mut reader = RevBufReader::new(inner);

let mut buffer = [0, 0, 0];
assert_eq!(reader.read(&mut buffer).ok(), Some(3));
assert_eq!(buffer, [5, 6, 7]);

let mut buffer = [0, 0, 0, 0, 0];
assert_eq!(reader.read(&mut buffer).ok(), Some(5));
assert_eq!(buffer, [0, 1, 2, 3, 4]);

Reading text lines in reverse order:

extern crate rev_buf_reader;

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

let data = "This\nis\na sentence";
let inner = io::Cursor::new(&data);
let reader = RevBufReader::new(inner);
let mut lines = reader.lines();

assert_eq!(lines.next().unwrap().unwrap(), "a sentence".to_string());
assert_eq!(lines.next().unwrap().unwrap(), "is".to_string());
assert_eq!(lines.next().unwrap().unwrap(), "This".to_string());
assert!(lines.next().is_none());

Features

rev_buf_reader has one feature: read_initializer, which corresponds to an experimental feature of nightly Rust. If you use it in your project by adding #![feature(read_initializer)], you'll need to enable it for rev_buf_reader as well in your Cargo.toml.

Dependencies

~245KB