StackBuf{Reader,Writer}

Stack buffer provides alternatives to BufReader and BufWriter allocated on the stack instead of the heap. Its implementation is mostly copied from the standard library and changed only when required to use the stack.

Usage

The nightly compiler is required.

Add the following to your Cargo.toml file:

[dependencies]
stack-buffer = "0.1.0"

Replace Buf{Reader,Writer}::{new,with_capacity} with StackBuf{Reader,Writer}::<_, N>::new where N is the allocated size on the stack.

Performance

StackBufReader always outperforms BufReader, typically by about 6%. Furthermore, the best stack size appears to be 4096 for reads under 1 MB and 8192 for 1 MB+ reads.

StackBufWriter does not appear to offer a significant benefit over BufWriter and is sometimes worse, but this may be due to benchmarking inaccuracies. 8192 appears to consistently be the best stack size.