read-byte-slice 0.1.2

An iterator over chunks of bytes as slices from an underlying reader.
Documentation

Build Status crates.io

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

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.