Crate unzip_n

Crate unzip_n 

Source
Expand description

CI crates.io docs.rs

Procedural macro for unzipping iterators-over-n-length-tuples into n collections.

Here’s a brief example of what it is capable of:

use unzip_n::unzip_n;

unzip_n!(pub 3);
use Unzip3 as _; // Just a verification of the trait name.
// Or simply leave the visibility modifier absent for inherited visibility
// (which usually means "private").
// unzip_n!(3);

let v = vec![(1, 2, 3), (4, 5, 6)];
let (v1, v2, v3) = v.into_iter().unzip_n_vec();

assert_eq!(v1, &[1, 4]);
assert_eq!(v2, &[2, 5]);
assert_eq!(v3, &[3, 6]);

Or you could give the trait an explicit name:

use unzip_n::unzip_n;

unzip_n!(pub MyTrait 3);
use MyTrait as _; // Just a verification that the trait is generated with the desired name.

let v = vec![(1, 2, 3), (4, 5, 6)];
let (v1, v2, v3) = v.into_iter().unzip_n_vec();

assert_eq!(v1, &[1, 4]);
assert_eq!(v2, &[2, 5]);
assert_eq!(v3, &[3, 6]);

Or generate multiple traits at once using a range:

use unzip_n::unzip_n;

unzip_n!(pub 2..=4);  // Generates Unzip2, Unzip3, Unzip4

let pairs = vec![(1, 2), (3, 4)];
let (v1, v2) = pairs.into_iter().unzip_n_vec();
assert_eq!(v1, &[1, 3]);
assert_eq!(v2, &[2, 4]);

let triples = vec![(1, 2, 3), (4, 5, 6)];
let (v1, v2, v3) = triples.into_iter().unzip_n_vec();
assert_eq!(v1, &[1, 4]);
assert_eq!(v2, &[2, 5]);
assert_eq!(v3, &[3, 6]);

With an explicit trait name prefix:

use unzip_n::unzip_n;

unzip_n!(pub MyUnzip 2..4);  // Generates MyUnzip2, MyUnzip3
use MyUnzip2 as _;
use MyUnzip3 as _;

§License

Licensed under either of

at your option.

§Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Macros§

unzip_n
Generates a trait and its implementation to “unzip” an iterator of N-sized tuple into N collections. Accepts either a single number or a range:
unzip_n_nostd
A no-std version of the unzip_n macro, i.e. without the unzip_n_vec trait method.