cpudetect 0.2.0

Ergonomic helpers for CPU feature detection
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

pub mod aarch64;
pub mod x86_64;

/// Expands a CPU family name into Rust `#[target_feature]` requirements.
///
/// Takes the family name as an attribute, e.g. `#[target_family("znver3")]`.
pub use cpudetect_macros::target_family;

macro_rules! declare_is_compatible {
    ($family:literal $(, $feature:literal)* $(,)?) => {
        pastey::paste! {
            #[doc = concat!(
                "Returns `true` if the current CPU is compatible with the `",
                $family,
                "` feature set."
            )]
            #[must_use]
            #[inline(always)]
            #[cfg(any(feature = "static", not(feature = "enabled")))]
            pub fn [<is_ $family _compatible>]() -> bool {
                true $(&& [<has_ $feature>]())*
            }

            #[doc = concat!(
                "Returns `true` if the current CPU is compatible with the `",
                $family,
                "` feature set."
            )]
            #[must_use]
            #[inline]
            #[cfg(not(any(feature = "static", not(feature = "enabled"))))]
            pub fn [<is_ $family _compatible>]() -> bool {
                // For non-static builds, cache family detection to avoid
                // long chains of feature detection calls.
                use std::sync::LazyLock;
                #[allow(non_upper_case_globals)]
                static [<lazy_ $family>]: LazyLock<bool> = LazyLock::new(|| {
                    true $(&& [<has_ $feature>]())*
                });
                *[<lazy_ $family>]
            }
        }
    };
}

pub(crate) use declare_is_compatible;