#intrinsics #simd

no-std safe_arch

Crate that exposes core::arch safely via #[cfg()]

14 releases

0.7.0 May 8, 2023
0.6.0 Jun 23, 2021
0.5.2 Aug 9, 2020
0.5.0 Jun 28, 2020
0.1.0 Apr 29, 2020

#61 in Hardware support

Download history 42061/week @ 2023-01-31 44366/week @ 2023-02-07 46463/week @ 2023-02-14 56662/week @ 2023-02-21 59018/week @ 2023-02-28 57041/week @ 2023-03-07 58803/week @ 2023-03-14 62030/week @ 2023-03-21 54447/week @ 2023-03-28 48765/week @ 2023-04-04 52331/week @ 2023-04-11 55065/week @ 2023-04-18 55212/week @ 2023-04-25 61651/week @ 2023-05-02 61237/week @ 2023-05-09 44332/week @ 2023-05-16

231,550 downloads per month
Used in 186 crates (via wide)

Zlib OR Apache-2.0 OR MIT

485KB
6.5K SLoC

License:Zlib Minimum Rust Version crates.io docs.rs

safe_arch

Exposes arch-specific intrinsics as safe function.

Design

The crate aims to be as minimal as possible.

  • SIMD types are newtype'd (with a pub field) and given appropriate trait impls such as From, Into, Default, etc.
  • Each intrinsic gets either a function or macro so that you can safely use it as directly as possible.
    • Functions are used when all arguments are runtime arguments.
    • Macros are used when one of the arguments must be a compile time constant, because Rust doesn't let you "pass through" compile time constants.
  • There's hundreds and hundreds of intrinsics, so the names of functions and macros tend to be very long and specific because there's often many similar ways to do nearly the same thing.
    • This crate isn't really intended for "everyday users". It is intended to be an "unopinionated" middle layer crate that just provides the safety. Higher level abstractions should mostly come from some other crate that wraps over this crate.

All function and macro availability is done purely at compile time via #[cfg()] attributes on the various modules. If a CPU feature isn't enabled for the build then those functions or macros won't be available. If you'd like to determine what CPU features are available at runtime and then call different code accordingly, this crate is not for you.

See the crate docs for more details.

Additional Resources

Black Lives Matter

Dependencies