orx-parallel 4.0.0

Performant parallel computations with an expressive iterator API.
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
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110

use crate::infallible_use::fun::UMap;
use crate::sizes::{Bin, One, Size};

pub trait XapUse: Copy + Send {
    type U;

    type I;

    type O;

    type Size: Size;

    type Values: IntoIterator<Item = Self::O>;

    fn xap_use(&self, u: *mut Self::U, i: Self::I) -> Self::Values;

    // transformations

    fn map<Q, H>(self, h: H) -> MapOf<Self, Q, H>
    where
        H: Fn(&mut Self::U, Self::O) -> Q + Copy + Send,
    {
        <Self::Size as Size>::u_map(self, h)
    }

    fn inspect<H>(self, h: H) -> InsOf<Self, H>
    where
        H: Fn(&mut Self::U, &Self::O) + Copy + Send,
    {
        <Self::Size as Size>::u_inspect(self, h)
    }

    fn filter<H>(self, h: H) -> FilOf<Self, H>
    where
        H: Fn(&mut Self::U, &Self::O) -> bool + Copy + Send,
    {
        <Self::Size as Size>::u_filter(self, h)
    }

    fn filter_map<Q, H>(self, h: H) -> FilMapOf<Self, Q, H>
    where
        H: Fn(&mut Self::U, Self::O) -> Option<Q> + Copy + Send,
    {
        <Self::Size as Size>::u_filter_map(self, h)
    }

    fn flat_map<V, H>(self, h: H) -> FlatMapOf<Self, V, H>
    where
        V: IntoIterator,
        H: Fn(&mut Self::U, Self::O) -> V + Copy + Send,
    {
        <Self::Size as Size>::u_flat_map(self, h)
    }

    fn flatten(self) -> FlattenOf<Self>
    where
        Self::O: IntoIterator,
    {
        <Self::Size as Size>::u_flatten(self)
    }

    // transformations - helper

    fn mapped<M>(self, m: M) -> MappedOf<Self, M>
    where
        M: UMap<U = Self::U, I = Self::O>,
    {
        <Self::Size as Size>::u_mapped(self, m)
    }
}

// one

pub trait XapUseOne: XapUse<Size = One> {
    #[inline(always)]
    fn one_value(&self, u: *mut Self::U, i: Self::I) -> Self::O {
        // SAFETY: by definition the result has exactly one element
        unsafe { self.xap_use(u, i).into_iter().next().unwrap_unchecked() }
    }
}

impl<X: XapUse<Size = One>> XapUseOne for X {}

// bin

pub trait XapUseBin: XapUse<Size = Bin> {
    #[inline(always)]
    fn bin_value(&self, u: *mut Self::U, i: Self::I) -> Option<Self::O> {
        // SAFETY: by definition the result has exactly zero or one element
        self.xap_use(u, i).into_iter().next()
    }
}

impl<X: XapUse<Size = Bin>> XapUseBin for X {}

// // helper types

pub type MapOf<X, Q, H> = <<X as XapUse>::Size as Size>::UMap<X, Q, H>;

pub type InsOf<X, H> = <<X as XapUse>::Size as Size>::UInspect<X, H>;

pub type FilOf<X, H> = <<X as XapUse>::Size as Size>::UFilter<X, H>;

pub type FilMapOf<X, Q, H> = <<X as XapUse>::Size as Size>::UFilterMap<X, Q, H>;

pub type FlatMapOf<X, V, H> = <<X as XapUse>::Size as Size>::UFlatMap<X, V, H>;

pub type FlattenOf<X> = <<X as XapUse>::Size as Size>::UFlatten<X>;

pub type MappedOf<X, M> = <<X as XapUse>::Size as Size>::UMapped<X, M>;