ggmath 0.16.5

A linear algebra library for games and graphics with generic SIMD 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

/// Bypasses a language limitation to safely call intrinsics.
///
/// Calling functions annotated with `#[target_feature]` is unsafe even if the
/// features are enabled for the current target architecture.
///
/// `safe_arch` hides the `#[target_feature]` annotation and fails compilation
/// if the features are not enabled for the current target architecture.
///
/// # Examples
///
/// `x86_64` `sse` example:
///
/// ```ignore
/// safe_arch! {
///     #![target_feature(enable = "sse")]
///
///     fn useless_code() {
///         println!("{:?}", core::arch::x86_64::_mm_set_ps(1.0, 2.0, 3.0, 4.0));
///     }
/// }
///
/// useless_code();
/// ```
#[allow(unused_macros)]
macro_rules! safe_arch {
    (
        #![target_feature(enable = $feature:literal)]

        $(
            $(#[$meta:meta])* fn $f:ident($($param:ident: $Param:ty),* $(,)?) $(-> $Ret:ty)? $body:block
        )*
    ) => {
        $(
            $(#[$meta])*
            fn $f($($param: $Param),*) $(-> $Ret)? {
                #[inline]
                #[target_feature(enable = $feature)]
                fn $f($($param: $Param),*) $(-> $Ret)? $body

                #[cfg(not(target_feature = $feature))]
                compile_error!(concat!("target feature is not enabled"));

                // SAFETY: If `$feature` is disabled, there will be a compile
                // error.
                unsafe { $f($($param),*) }
            }
        )*
    };
}

#[allow(unused_imports)]
pub(crate) use safe_arch;