Portable Bitwise Manipulation Intrinsics

0b0000_0010_1001_1010 (nightly-only)

The intrinsics are named after their CPU instruction and organized in modules named after their instruction set: bitintr::{instruction_set}::{intrinsic_name}.

They are implemented for all integer types except u128/i128. Whether a fallback software implementation is used depends on the integer types involved and the instruction sets supported by the target.

The following instruction sets are implemented:

• ABM: Advanced Bit Manipulation instructions.
• TBM: Trailing Bit Manipulation instructions.
• BMI: Bit Manipulation Instruction Set 1.0.
• BMI2: Bit Manipulation Instruction Set 2.0.

Example

```rust extern crate bitintr; use bitintr::bmi2::*;

fn main() { let x = 1; let y = 0; // Intrinsics can be used as methods: let methodcall = x.pdep(y); // And as free function calls: let freecall = pdep(x, y); asserteq!(methodcall, free_call); } ```

Nightly-only

This crate relies on the following nightly features:

• cfg_target_feature for target-dependent behavior,
• platform_intrinsics for using the bitwise manipulation intrinsics, and
• u128 support for efficient lossless unsigned 64bit multiplication.

For more information, visit the documentation page.