3 stable releases
Uses old Rust 2015
1.2.0 | Dec 4, 2016 |
---|---|
1.1.0 | Dec 2, 2016 |
1.0.0 | Dec 24, 2015 |
#53 in #collect
288 downloads per month
Used in 2 crates
11KB
130 lines
collect_slice
Collect an iterator into a slice.
Rust comes with the Iterator::collect
method for collecting an iterator's items into
a heap-allocated Vec
or any other type that implements FromIterator
, but there's
no way to collect items into a stack-allocated array without manually looping over the
iterator. This crates provides an alternative with collect_slice
methods that
collect an iterator's items into a mutable slice (of a stack-allocated array or
otherwise.)
The trait is automatically implemented for any type that implements Iterator
.
Examples
use collect_slice::CollectSlice;
let mut orig = [0; 8];
(0..8).map(|i| i * 2).collect_slice_checked(&mut orig[..]);
assert_eq!(orig, [0, 2, 4, 6, 8, 10, 12, 14]);
let mut buf = [42; 8];
orig.iter()
.map(|&x| x + 10)
.collect_slice_checked(&mut buf[..]);
assert_eq!(buf, [10, 12, 14, 16, 18, 20, 22, 24]);
Usage
This crate can be used through cargo by adding it as a dependency in Cargo.toml
:
[dependencies]
collect_slice = "^1.2.0"
and importing it in the crate root:
extern crate collect_slice;
The provided methods can then be used by importing the trait within individual modules:
use collect_slice::CollectSlice;