pistonite-cu 0.8.3

Battery-included common utils to speed up development of rust tools
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

use std::sync::atomic::{AtomicUsize, Ordering};

/// An atomic wrapper with an underlying atomic storage and conversion to
/// a type T.
///
/// `Acquire` ordering is used for load and `Release` ordering is used for store.
///
/// A proc macro might be provided in the future to simplify declaring a compatible enum type.
///
/// ```rust
/// # use pistonite_cu as cu;
/// #[derive(Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord, Hash)]
/// #[repr(u8)]
/// pub enum MyEnum {
///    A,
///    B,
///    C,
///    Invalid, //
/// }
/// impl From<u8> for MyEnum {
///     fn from(value: u8) -> Self {
///         match value {
///             0 => Self::A,
///             1 => Self::B,
///             2 => Self::C,
///             _ => Self::Invalid,
///         }
///     }
/// }
/// impl From<MyEnum> for u8 {
///     fn from(value: MyEnum) -> Self {
///         value as Self
///     }
/// }
///
/// # fn main() {
/// let value: cu::Atomic<u8, MyEnum> = cu::Atomic::new_u8(MyEnum::A as u8);
/// assert_eq!(MyEnum::A, value.get());
/// value.set(MyEnum::C);
/// assert_eq!(MyEnum::C, value.get());
/// # }
/// ```
#[derive(Debug, Default)]
pub struct Atomic<S, T>(S::Type, std::marker::PhantomData<T>)
where
    S: AtomicType,
    T: From<S> + Into<S>;
/// Marker type to associate primitive with their atomic versions
pub trait AtomicType {
    type Type;
}
macro_rules! impl_atomic_type {
    ($($t:ident => $Atomic:ident, $newfn:ident),* $(,)?) => { $(
    impl AtomicType for $t {
        type Type = std::sync::atomic::$Atomic;
    }
    impl<T: From<$t> + Into<$t>> Atomic<$t, T> {
        pub const fn $newfn(value: $t) -> Self {
            Self(std::sync::atomic::$Atomic::new(value), std::marker::PhantomData)
        }
        pub fn get(&self) -> T {
            self.0.load(std::sync::atomic::Ordering::Acquire).into()
        }
        pub fn set(&self, value: T) {
            self.0.store(value.into(), std::sync::atomic::Ordering::Release)
        }
    }
    )* }
}
impl_atomic_type! {
    i8 => AtomicI8, new_i8,
    i16 => AtomicI16, new_i16,
    i32 => AtomicI32, new_i32,
    i64 => AtomicI64, new_i64,
    u8 => AtomicU8, new_u8,
    u16 => AtomicU16, new_u16,
    u32 => AtomicU32, new_u32,
    u64 => AtomicU64, new_u64,
    bool => AtomicBool, new_bool,
    isize => AtomicIsize, new_isize,
    usize => AtomicUsize, new_usize,
}

#[allow(unused)]
pub(crate) fn next_atomic_usize() -> usize {
    static ID: AtomicUsize = AtomicUsize::new(1);
    ID.fetch_add(1, Ordering::SeqCst)
}