num_convert 0.7.2

Type converting library, conversions integers by overflow addition, supports generics types.
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

/// The FromAs generic trait for convert from value between integer types with possible overflow.
/// - Can use conversion with overflow in generic code.
///
/// # Usage
/// Basic use of the trait.
///
/// ```
/// use num_convert::FromAs;
/// assert_eq!(<u8 as FromAs<i8>>::from_as(-128_i8), 128_u8);
/// assert_eq!(<i8>::from_as(128_u8), -128_i8);
/// ```
///
/// # Examples
///
/// ```
/// # use num_convert::FromAs;
/// assert_eq!(<u8>::from_as(258_u16), 2_u8);
/// assert_eq!(<u8 as FromAs<u16>>::from_as(255_u16), 255_u8);
/// ```
pub trait FromAs<T> {
    /// Convert from value between integer types with overflow.
    fn from_as(n: T) -> Self;
}

macro_rules! from_as_impls {
    ( $($type:ty),*; $for_type:ty ) => {
        impl FromAs<$for_type> for $for_type {
            #[doc = concat!("Returns the same type ", stringify!($for_type), ".")]
            #[inline]
            fn from_as(num: $for_type) -> Self {
                num
            }
        }

        $(
            impl FromAs<$type> for $for_type {
                #[doc = concat!("Converts ", stringify!($type), " to ", stringify!($for_type), ".")]
                #[inline]
                fn from_as(num: $type) -> Self {
                    num as Self
                }
            }
        )*
    }
}

from_as_impls! { u8, i16, u16, i32, u32, i64, u64, isize, usize, i128, u128; i8 }
from_as_impls! { i8, i16, u16, i32, u32, i64, u64, isize, usize, i128, u128; u8 }
from_as_impls! { i8, u8, u16, i32, u32, i64, u64, isize, usize, i128, u128; i16 }
from_as_impls! { i8, u8, i16, i32, u32, i64, u64, isize, usize, i128, u128; u16 }
from_as_impls! { i8, u8, i16, u16, u32, i64, u64, isize, usize, i128, u128; i32 }
from_as_impls! { i8, u8, i16, u16, i32, i64, u64, isize, usize, i128, u128; u32 }
from_as_impls! { i8, u8, i16, u16, i32, u32, u64, isize, usize, i128, u128; i64 }
from_as_impls! { i8, u8, i16, u16, i32, u32, i64, isize, usize, i128, u128; u64 }
from_as_impls! { i8, u8, i16, u16, i32, u32, i64, u64, usize, i128, u128; isize }
from_as_impls! { i8, u8, i16, u16, i32, u32, i64, u64, isize, i128, u128; usize }
from_as_impls! { i8, u8, i16, u16, i32, u32, i64, u64, isize, usize, u128; i128 }
from_as_impls! { i8, u8, i16, u16, i32, u32, i64, u64, isize, usize, i128; u128 }