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
use word::Word;
use bitintr;
/// Returns mask with the least significant zero bit of `x` set to 1.
///
/// All other bits of the mask are set to zero. If `x` contains only set bits,
/// returns 0.
///
/// # Intrinsics:
/// - TBM: blcic (or: blci, not).
///
/// # Examples
///
/// ```
/// use bitwise::word::*;
///
/// let n = 0b0101;
/// let s = 0b0010;
///
/// assert_eq!(n.isolate_least_significant_zero(), s);
/// assert_eq!(isolate_least_significant_zero(0b1111_1111u8), 0u8);
/// ```
#[inline]
pub fn isolate_least_significant_zero<T: Word>(x: T) -> T {
bitintr::x86::tbm::blcic(x)
}
/// Method version of [`isolate_least_significant_zero`](fn.isolate_least_significant_zero.html).
pub trait IsolateLeastSignificantZero {
#[inline]
fn isolate_least_significant_zero(self) -> Self;
}
impl<T: Word> IsolateLeastSignificantZero for T {
#[inline]
fn isolate_least_significant_zero(self) -> Self {
isolate_least_significant_zero(self)
}
}