zip_clone

Crates.iozip_clone
lib.rszip_clone
version0.1.1
sourcesrc
created_at2024-04-20 09:09:28.111742
updated_at2024-06-18 20:33:13.586881
descriptionZip an iterator to a repeately cloned object
homepage
repositoryhttps://github.com/jongiddy/zip_clone
max_upload_size
id1214467
size20,440
(jongiddy)

documentation

README

zip_clone

Zip an iterator to a repeately cloned object.

Pass an owned object that implements Clone to create an iterator that zips the original iterator with clones of the object.

One iteration returns the original object, hence using one fewer clones than iter.zip(repeat_with(|| cloned.clone())).

This is useful for loops where a value is cloned for each iteration, but is not used after the iteration.

Instead of cloning a value 10 times using:

let mut v = vec![];
let s = String::from("Hello");
for _ in 0..10 {
    v.push(s.clone());
}

clone the value 9 times using:

use zip_clone::ZipClone as _;

let mut v = vec![];
let s = String::from("Hello");
for (_, s) in (0..10).zip_clone(s) {
    v.push(s);
}

The object may be cloned even fewer times if items are skipped. For example, last() consumes the iterator but returns the last value without cloning the object for intermediate values:

use zip_clone::ZipClone as _;

let mut v = vec![];
let s = String::from("Hello");
v.push((0..10).zip_clone(s).last());
Commit count: 2

cargo fmt