safe_arch

Crates.iosafe_arch
lib.rssafe_arch
version0.7.1
sourcesrc
created_at2020-04-29 02:53:57.692152
updated_at2023-07-17 15:53:42.229364
descriptionCrate that exposes `core::arch` safely via `#[cfg()]`.
homepage
repositoryhttps://github.com/Lokathor/safe_arch
max_upload_size
id235203
size579,791
Lokathor (Lokathor)

documentation

README

Docs.rs

safe_arch

Exposes arch-specific intrinsics as safe function.

  • 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

Commit count: 151

cargo fmt