array__ops 1.0.3

A selection of useful array operations
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77

use core::pin::Pin;

use array_trait::Array;
use slice_ops::AsSlice;

use crate::form::ArrayForm;

use super::ArrayZipWith;

#[const_trait]
pub trait ArrayZip<T, const N: usize>: Array + AsSlice<Item = T>
{
    /// Combines two arrays with possibly different items into parallel, where each element lines up in the same position.
    /// 
    /// This method can be executed at compile-time, as opposed to the standard-library method.
    /// 
    /// # Example
    /// 
    /// ```rust
    /// use array__ops::ops::*;
    /// 
    /// const A: [u8; 4] = [4, 3, 2, 1];
    /// const B: [&str; 4] = ["four", "three", "two", "one"];
    /// let c = A.zip(B);
    /// 
    /// assert_eq!(c, [(4, "four"), (3, "three"), (2, "two"), (1, "one")]);
    /// ```
    fn zip<Z>(self, other: Z) -> [(T, Z::Elem); N]
    where
        Z: ArrayForm<N>;
    fn zip_ref<Z>(&self, other: Z) -> [(&T, Z::Elem); N]
    where
        Z: ArrayForm<N>;
    fn zip_mut<Z>(&mut self, other: Z) -> [(&mut T, Z::Elem); N]
    where
        Z: ArrayForm<N>;
    fn zip_pin_ref<Z>(self: Pin<&Self>, other: Z) -> [(Pin<&T>, Z::Elem); N]
    where
        Z: ArrayForm<N>;
    fn zip_pin_mut<Z>(self: Pin<&mut Self>, other: Z) -> [(Pin<&mut T>, Z::Elem); N]
    where
        Z: ArrayForm<N>;
}

impl<T, const N: usize> ArrayZip<T, N> for [T; N]
{
    fn zip<Z>(self, other: Z) -> [(T, Z::Elem); N]
    where
        Z: ArrayForm<N>
    {
        self.zip_with(other, const |x, y| (x, y))
    }
    fn zip_ref<Z>(&self, other: Z) -> [(&T, Z::Elem); N]
    where
        Z: ArrayForm<N>
    {
        self.zip_ref_with(other, const |x, y| (x, y))
    }
    fn zip_mut<Z>(&mut self, other: Z) -> [(&mut T, Z::Elem); N]
    where
        Z: ArrayForm<N>
    {
        self.zip_mut_with(other, const |x, y| (x, y))
    }
    fn zip_pin_ref<Z>(self: Pin<&Self>, other: Z) -> [(Pin<&T>, Z::Elem); N]
    where
        Z: ArrayForm<N>
    {
        self.zip_pin_ref_with(other, const |x, y| (x, y))
    }
    fn zip_pin_mut<Z>(self: Pin<&mut Self>, other: Z) -> [(Pin<&mut T>, Z::Elem); N]
    where
        Z: ArrayForm<N>
    {
        self.zip_pin_mut_with(other, const |x, y| (x, y))
    }
}