#buffer #no-alloc #io-read

no-std load-buffer

Crate for loading data into a fixed-sized buffer. Similar to BufRead, but allowing static or dynamic sizes, and no_std use.

4 releases (1 stable)

1.0.0 Nov 17, 2023
0.1.3 Nov 17, 2023
0.1.2 Nov 17, 2023
0.1.0 Nov 17, 2023

#147 in No standard library

39 downloads per month
Used in rand_blake3

MPL-2.0 license

14KB
240 lines

load-buffer

Simple Rust crate for loading data into a fixed-sized buffer. Similar to BufReader, but allowing static or dynamic buffers, and no_std use.

To use this, you'll need to implement Load for your type (std::io::Read types automatically implement this), then load it into a BufferedLoader:

// Static, backed by the array size you give it:
let mut loader: BufferedLoader<[u8; 64], _> =
    BufferedLoader::new_static(Loader::default());
// Dynamic, backed by alloc::vec::Vec<u8>:
let mut loader = BufferedLoader::new_dynamic(Loader::default(), 64);
// Dynamic can be resized.  This invalidates the buffer.
loader.resize(268435456);
// Heap, backed by alloc::boxed::Box<[u8]>:
let mut loader = BufferedLoader::new_heap(Loader::default(), 268435456);
// Heap can not be resized, but will not fill the stack for huge sizes.

// You can also supply your own buffer type, as long as it implements
// AsRef<[u8]> + AsMut<[u8]> + Debug.

No runtime deps

Features