#byte-slice #byte #chunk #iterator

read-byte-slice

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

3 releases

Uses old Rust 2015

0.1.2 Dec 8, 2017
0.1.1 Sep 5, 2017
0.1.0 Sep 1, 2017

#1930 in Algorithms

Download history 6/week @ 2023-11-27 3/week @ 2024-01-08 10/week @ 2024-02-12 9/week @ 2024-02-19 72/week @ 2024-02-26 14/week @ 2024-03-04 7/week @ 2024-03-11

104 downloads per month
Used in 2 crates

MIT/Apache

9KB
112 lines

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.

Dependencies

~23KB