conv/
misc.rs

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
/*!
This module defines some additional traits not *directly* tied to conversions.
*/

/**
This trait indicates that values of a type can be logically "saturated".

This is used by the `errors::UnwrapOrSaturate` extension trait.
*/
pub trait Saturated {
    /// Returns the type's saturated, maximum value.
    fn saturated_max() -> Self;

    /// Returns the type's saturated, minimum value.
    fn saturated_min() -> Self;
}

item_for_each! {
    (i8), (i16), (i32), (i64), (u8), (u16), (u32), (u64), (isize), (usize) => {
        ($ity:ident) => {
            impl Saturated for $ity {
                #[inline] fn saturated_max() -> Self { ::std::$ity::MAX }
                #[inline] fn saturated_min() -> Self { ::std::$ity::MIN }
            }
        };
    }
}

/**
This trait indicates that a type has an "invalid" sentinel value.

This is used by the `errors::UnwrapOrInvalid` extension trait.
*/
pub trait InvalidSentinel {
    /// Returns the type's "invalid" sentinel value.
    fn invalid_sentinel() -> Self;
}

item_for_each! {
    (f32), (f64) => {
        ($ity:ident) => {
            impl InvalidSentinel for $ity {
                #[inline] fn invalid_sentinel() -> Self { ::std::$ity::NAN }
            }
        };
    }
}

/**
This trait indicates that a type has positive and negative "infinity" values.

This is used by the `errors::UnwrapOrInf` extension trait.
*/
pub trait SignedInfinity {
    /// Returns the type's positive infinity value.
    fn neg_infinity() -> Self;

    /// Returns the type's negative infinity value.
    fn pos_infinity() -> Self;
}

item_for_each! {
    (f32), (f64) => {
        ($ity:ident) => {
            impl SignedInfinity for $ity {
                #[inline] fn neg_infinity() -> Self { ::std::$ity::NEG_INFINITY }
                #[inline] fn pos_infinity() -> Self { ::std::$ity::INFINITY }
            }
        };
    }
}