strided-kernel 0.1.1

Cache-optimized kernels for strided multidimensional array operations in Rust (ported from Julia Strided.jl/StridedViews.jl).
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

//! Feature-gated Send/Sync marker traits.
//!
//! When the `parallel` feature is enabled, [`MaybeSend`] ≡ [`Send`],
//! [`MaybeSync`] ≡ [`Sync`], and [`MaybeSendSync`] ≡ [`Send`] + [`Sync`].
//!
//! When `parallel` is disabled, these traits are blanket-implemented
//! for all types, so non-thread-safe types can use the kernel APIs.

// ---- parallel enabled: alias to real Send/Sync ----

/// Equivalent to [`Send`] when `parallel` is enabled; blanket-impl otherwise.
#[cfg(feature = "parallel")]
pub trait MaybeSend: Send {}
#[cfg(feature = "parallel")]
impl<T: Send> MaybeSend for T {}

/// Equivalent to [`Sync`] when `parallel` is enabled; blanket-impl otherwise.
#[cfg(feature = "parallel")]
pub trait MaybeSync: Sync {}
#[cfg(feature = "parallel")]
impl<T: Sync> MaybeSync for T {}

/// Equivalent to [`Send`] + [`Sync`] when `parallel` is enabled; blanket-impl otherwise.
#[cfg(feature = "parallel")]
pub trait MaybeSendSync: Send + Sync {}
#[cfg(feature = "parallel")]
impl<T: Send + Sync> MaybeSendSync for T {}

// ---- parallel disabled: blanket impl for all types ----

/// Equivalent to [`Send`] when `parallel` is enabled; blanket-impl otherwise.
#[cfg(not(feature = "parallel"))]
pub trait MaybeSend {}
#[cfg(not(feature = "parallel"))]
impl<T> MaybeSend for T {}

/// Equivalent to [`Sync`] when `parallel` is enabled; blanket-impl otherwise.
#[cfg(not(feature = "parallel"))]
pub trait MaybeSync {}
#[cfg(not(feature = "parallel"))]
impl<T> MaybeSync for T {}

/// Equivalent to [`Send`] + [`Sync`] when `parallel` is enabled; blanket-impl otherwise.
#[cfg(not(feature = "parallel"))]
pub trait MaybeSendSync {}
#[cfg(not(feature = "parallel"))]
impl<T> MaybeSendSync for T {}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_f64_satisfies_maybe_traits() {
        fn _check_send<T: MaybeSend>() {}
        fn _check_sync<T: MaybeSync>() {}
        fn _check_send_sync<T: MaybeSendSync>() {}
        _check_send::<f64>();
        _check_sync::<f64>();
        _check_send_sync::<f64>();
    }

    #[cfg(not(feature = "parallel"))]
    #[test]
    fn test_rc_satisfies_maybe_traits_without_parallel() {
        use std::rc::Rc;
        fn _check_send<T: MaybeSend>() {}
        fn _check_sync<T: MaybeSync>() {}
        fn _check_send_sync<T: MaybeSendSync>() {}
        _check_send::<Rc<f64>>();
        _check_sync::<Rc<f64>>();
        _check_send_sync::<Rc<f64>>();
    }
}