21 releases
0.3.0 | Jun 20, 2019 |
---|---|
0.2.0 | May 11, 2018 |
0.1.18 | Feb 23, 2017 |
0.1.14 | Jan 31, 2017 |
#219 in Hardware support
19,940 downloads per month
Used in 10 crates
(7 directly)
63KB
1K
SLoC
Portable Bitwise Manipulation Intrinsics
0b0000_0010_1001_1010
This #![no_std]
library exposes safe and portable low-level bit manipulation
instruction set architectures. The Minimum Supported Rust Version is 1.36.0.
For higher-level bitwise manipulations check the bitwise crate.
The intrinsics are exposed via traits named after their CPU instruction. These
traits are implemented for all integer types except u128/i128
.
The following ISAs are implemented:
-
x86 (
bitintr::x86
):ABM
: Advanced Bit Manipulation instructions (bitintr::x86::abm
).TBM
: Trailing Bit Manipulation instructions (bitintr::x86::tbm
).BMI
: Bit Manipulation Instruction Set 1.0 (bitintr::x86::bmi
).BMI2
: Bit Manipulation Instruction Set 2.0 (bitintr::x86::bmi2
).
-
ARM (
bitintr::arm
):
The actual code generated depends on the integer types involved and the features supported by the target architecture.
Verified assembly
The check_asm.py
script verifies the generated assembly of the
intrinsics. It compiles the asm/arch_feature_*.rs
for the appropriate
architectures and target features and compares the assembly generated by rustc
with that included in the corresponding asm/arch_feature_*.asm
files.
License
Licensed under the MIT license.
Contribution
Yes please! Just note that all contributions shall be licensed as above without any additional terms or conditions.