[![Build Status](https://travis-ci.org/luser/read-byte-slice.svg?branch=master)](https://travis-ci.org/luser/read-byte-slice) [![crates.io](https://img.shields.io/crates/v/read-byte-slice.svg)](https://crates.io/crates/read-byte-slice) [![](https://docs.rs/read-byte-slice/badge.svg)](https://docs.rs/read-byte-slice)
This crate implements a type `ByteSliceIter` that reads bytes from a reader and allows iterating
over them as slices with a maximum length, similar to the [`chunks`] method on slices.
It is implemented as a [`FallibleStreamingIterator`] so that it can reuse its buffer and not
allocate for each chunk. (That trait is re-exported here for convenience.)
# Example
```rust
extern crate read_byte_slice;
use read_byte_slice::{ByteSliceIter, FallibleStreamingIterator};
use std::io;
fn work() -> io::Result<()> {
let bytes = b"0123456789abcdef0123456789abcdef";
// Iterate over the bytes in 8-byte chunks.
let mut iter = ByteSliceIter::new(&bytes[..], 8);
while let Some(chunk) = iter.next()? {
println!("{:?}", chunk);
}
Ok(())
}
fn main() {
work().unwrap();
}
```
# License
`read-byte-slice` is distributed under the terms of both the MIT license and
the Apache License (Version 2.0).
See LICENSE-APACHE and LICENSE-MIT for details.
[`chunks`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks
[`FallibleStreamingIterator`]: https://docs.rs/fallible-streaming-iterator/*/fallible_streaming_iterator/trait.FallibleStreamingIterator.html