radiate-utils 1.3.1

A Rust library for genetic algorithms and artificial evolution.
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 crate::{DataType, Primitive};

pub trait Integer: Primitive + num_traits::PrimInt {
    const DTYPE: DataType;

    fn safe_clamp(self, min: Self, max: Self) -> Self {
        if self < min {
            min
        } else if self > max {
            max
        } else {
            self
        }
    }
}

#[macro_export]
macro_rules! impl_integer {
    ($t:ty, $dtype:ident) => {
        impl Primitive for $t {
            const HALF: Self = 0.5 as Self;
            const MIN: Self = <$t>::MIN;
            const MAX: Self = <$t>::MAX;
            const ZERO: Self = 0;
            const ONE: Self = 1;
            const TWO: Self = 2;

            #[inline]
            fn safe_add(self, rhs: Self) -> Self {
                self.saturating_add(rhs)
            }

            #[inline]
            fn safe_sub(self, rhs: Self) -> Self {
                self.saturating_sub(rhs)
            }

            #[inline]
            fn safe_mul(self, rhs: Self) -> Self {
                self.saturating_mul(rhs)
            }

            #[inline]
            fn safe_div(self, rhs: Self) -> Self {
                if rhs == Self::ZERO {
                    self
                } else {
                    self.saturating_div(rhs)
                }
            }

            #[inline]
            fn safe_mean(self, rhs: Self) -> Self {
                self.safe_add(rhs).safe_div(Self::TWO)
            }

            #[inline]
            fn is_equal(self, rhs: Self) -> bool {
                self == rhs
            }
        }

        impl Integer for $t {
            const DTYPE: DataType = DataType::$dtype;

            fn safe_clamp(self, min: Self, max: Self) -> Self {
                if self < min {
                    min
                } else if self > max {
                    max
                } else {
                    self
                }
            }
        }
    };
}

impl_integer!(i8, Int8);
impl_integer!(i16, Int16);
impl_integer!(i32, Int32);
impl_integer!(i64, Int64);
impl_integer!(i128, Int128);
impl_integer!(u8, UInt8);
impl_integer!(u16, UInt16);
impl_integer!(u32, UInt32);
impl_integer!(u64, UInt64);
impl_integer!(u128, UInt128);