Struct I16 

#[repr(transparent)]
pub struct I16(pub i16);

Transparent wrapper for i16.

Tuple Fields

0: i16

Trait Implementations

impl Add for I16

type Output = I16

The resulting type after applying the + operator.

fn add(self, rhs: I16) -> I16

Performs the + operation.

impl AddAssign for I16

fn add_assign(&mut self, rhs: I16)

Performs the += operation.

impl CastFrom<Bf4> for I16

fn cast_from(val: Bf4) -> I16

Cast from type T to Self.

impl CastFrom<Bf8> for I16

fn cast_from(val: Bf8) -> I16

Cast from type T to Self.

impl CastFrom<Bf16> for I16

fn cast_from(val: Bf16) -> I16

Cast from type T to Self.

impl CastFrom<F4> for I16

fn cast_from(val: F4) -> I16

Cast from type T to Self.

impl CastFrom<F8> for I16

fn cast_from(val: F8) -> I16

Cast from type T to Self.

impl CastFrom<F16> for I16

fn cast_from(val: F16) -> I16

Cast from type T to Self.

impl CastFrom<F32> for I16

fn cast_from(val: F32) -> I16

Cast from type T to Self.

impl CastFrom<F64> for I16

fn cast_from(val: F64) -> I16

Cast from type T to Self.

impl CastFrom<I8> for I16

fn cast_from(val: I8) -> I16

Cast from type T to Self.

impl CastFrom<I16> for f32

fn cast_from(val: I16) -> f32

Cast from type T to Self.

impl CastFrom<I16> for f64

fn cast_from(val: I16) -> f64

Cast from type T to Self.

impl CastFrom<I16> for i8

fn cast_from(val: I16) -> i8

Cast from type T to Self.

impl CastFrom<I16> for i16

fn cast_from(val: I16) -> i16

Cast from type T to Self.

impl CastFrom<I16> for i32

fn cast_from(val: I16) -> i32

Cast from type T to Self.

impl CastFrom<I16> for F16

fn cast_from(val: I16) -> F16

Cast from type T to Self.

impl CastFrom<I16> for F32

fn cast_from(val: I16) -> F32

Cast from type T to Self.

impl CastFrom<I16> for F64

fn cast_from(val: I16) -> F64

Cast from type T to Self.

impl CastFrom<I16> for Bf16

fn cast_from(val: I16) -> Bf16

Cast from type T to Self.

impl CastFrom<I16> for Bf8

fn cast_from(val: I16) -> Bf8

Cast from type T to Self.

impl CastFrom<I16> for Bf4

fn cast_from(val: I16) -> Bf4

Cast from type T to Self.

impl CastFrom<I16> for F8

fn cast_from(val: I16) -> F8

Cast from type T to Self.

impl CastFrom<I16> for F4

fn cast_from(val: I16) -> F4

Cast from type T to Self.

impl CastFrom<I16> for I16

fn cast_from(val: I16) -> I16

Cast from type T to Self.

impl CastFrom<I16> for I8

fn cast_from(val: I16) -> I8

Cast from type T to Self.

impl CastFrom<I16> for I32

fn cast_from(val: I16) -> I32

Cast from type T to Self.

impl CastFrom<I32> for I16

fn cast_from(val: I32) -> I16

Cast from type T to Self.

impl CastFrom<f32> for I16

fn cast_from(val: f32) -> I16

Cast from type T to Self.

impl CastFrom<f64> for I16

fn cast_from(val: f64) -> I16

Cast from type T to Self.

impl CastFrom<i8> for I16

fn cast_from(val: i8) -> I16

Cast from type T to Self.

impl CastFrom<i16> for I16

fn cast_from(val: i16) -> I16

Cast from type T to Self.

impl CastFrom<i32> for I16

fn cast_from(val: i32) -> I16

Cast from type T to Self.

impl Clone for I16

fn clone(&self) -> I16

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for I16

impl Debug for I16

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Default for I16

fn default() -> I16

Returns the “default value” for a type.

impl Div for I16

type Output = I16

The resulting type after applying the / operator.

fn div(self, rhs: I16) -> I16

Performs the / operation.

impl Eq for I16

impl Hash for I16

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Mul for I16

type Output = I16

The resulting type after applying the * operator.

fn mul(self, rhs: I16) -> I16

Performs the * operation.

impl MulAssign for I16

fn mul_assign(&mut self, rhs: I16)

Performs the *= operation.

impl Neg for I16

type Output = I16

The resulting type after applying the - operator.

fn neg(self) -> I16

Performs the unary - operation.

impl NumericElement for I16

fn saturating_add(self, rhs: I16) -> I16

Native saturating_add replacement for the float-default self + rhs (which silently wraps on integer overflow in release / panics in debug). Caps at MAX_VALUE/MIN_VALUE.

fn saturating_mul(self, rhs: I16) -> I16

Native saturating_mul; see Self::saturating_add.

fn checked_add(self, rhs: I16) -> Option<I16>

Native checked_add returning None on integer overflow instead of the float-default Some(self + rhs), which silently wraps.

fn checked_mul(self, rhs: I16) -> Option<I16>

Native checked_mul; see Self::checked_add.

const ZERO: I16

Additive identity.

const ONE: I16

Multiplicative identity.

const NAN: I16

IEEE 754 not-a-number sentinel.

const INFINITY: I16

IEEE 754 positive infinity.

const MIN_VALUE: I16

The minimum representable finite value (negative infinity or i32::MIN).

const MAX_VALUE: I16

The maximum representable finite value (positive infinity or i32::MAX).

const BYTE_WIDTH: usize = 2

Number of bytes per element.

const ALL_ONES: I16

Bitwise representation with all bits set to 1.

const SIGN_MASK: I16

IEEE 754 sign-bit mask: only the most-significant bit is set.

fn abs(self) -> I16

Absolute value.

fn scalar_fmadd(self, b: I16, c: I16) -> I16

Scalar fused multiply-add: (self * b) + c.

fn sqrt(self) -> I16

Square root. Floats follow IEEE 754 (NaN for negative inputs); integers return the exact floor integer square root (isqrt), with negative signed inputs defined to return 0 (integers have no NaN to signal the domain error). No f64 round-trip, so the integer result is exact for all operands.

fn is_finite(self) -> bool

Returns true if finite.

fn is_nan(self) -> bool

Returns true if NaN.

fn to_f64(self) -> f64

Cast to f64.

fn bitand(self, rhs: I16) -> I16

Bitwise AND.

fn bitor(self, rhs: I16) -> I16

Bitwise OR.

fn bitxor(self, rhs: I16) -> I16

Bitwise XOR.

fn count_ones(self) -> u32

Count set bits (population count).

fn min_scalar(self, other: Self) -> Self

where Self: PartialOrd,

Elementwise minimum: returns self if self <= other, else other.

fn max_scalar(self, other: Self) -> Self

where Self: PartialOrd,

Elementwise maximum: returns self if self >= other, else other.

impl Ord for I16

fn cmp(&self, other: &I16) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for I16

fn eq(&self, other: &I16) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl PartialOrd for I16

fn partial_cmp(&self, other: &I16) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Pod for I16

impl Pod for I16

impl SimdKernel<I16> for Scalar

const LANE_COUNT: usize = 8

Number of primitive elements of type T in one Vector.

const UNROLL_FACTOR: usize = 4

Loop unrolling register accumulation factor to break loop-carried dependency chains.

type Vector = [I16; 8]

The underlying raw register/vector type for this architecture and element type.

type Mask = [bool; 8]

Hardware-native mask type.

type IndexVector = [i32; 8]

Integer index vector for gather operations.

unsafe fn load_aligned(ptr: *const I16) -> <Scalar as SimdKernel<I16>>::Vector

Load a vector from an aligned pointer.

unsafe fn load_unaligned(ptr: *const I16) -> <Scalar as SimdKernel<I16>>::Vector

Load a vector from an unaligned pointer.

unsafe fn store_aligned(ptr: *mut I16, val: <Scalar as SimdKernel<I16>>::Vector)

Store a vector to an aligned pointer.

unsafe fn store_unaligned( ptr: *mut I16, val: <Scalar as SimdKernel<I16>>::Vector, )

Store a vector to an unaligned pointer.

unsafe fn add( a: <Scalar as SimdKernel<I16>>::Vector, b: <Scalar as SimdKernel<I16>>::Vector, ) -> <Scalar as SimdKernel<I16>>::Vector

Elementwise addition: a + b.

unsafe fn mul( a: <Scalar as SimdKernel<I16>>::Vector, b: <Scalar as SimdKernel<I16>>::Vector, ) -> <Scalar as SimdKernel<I16>>::Vector

Elementwise multiplication: a * b.

unsafe fn sub( a: <Scalar as SimdKernel<I16>>::Vector, b: <Scalar as SimdKernel<I16>>::Vector, ) -> <Scalar as SimdKernel<I16>>::Vector

Elementwise subtraction: a - b.

unsafe fn neg( a: <Scalar as SimdKernel<I16>>::Vector, ) -> <Scalar as SimdKernel<I16>>::Vector

Elementwise negate: -a.

unsafe fn fmadd( a: <Scalar as SimdKernel<I16>>::Vector, b: <Scalar as SimdKernel<I16>>::Vector, c: <Scalar as SimdKernel<I16>>::Vector, ) -> <Scalar as SimdKernel<I16>>::Vector

Fused multiply-add: (a * b) + c.

unsafe fn sum_reduce(v: <Scalar as SimdKernel<I16>>::Vector) -> I16

Horizontal sum of all lanes.

unsafe fn compress( src: <Scalar as SimdKernel<I16>>::Vector, mask: <Scalar as SimdKernel<I16>>::Mask, ) -> <Scalar as SimdKernel<I16>>::Vector

Compress: pack selected lanes (where mask[i]=1) into the low lanes of the result.

unsafe fn expand( src: <Scalar as SimdKernel<I16>>::Vector, mask: <Scalar as SimdKernel<I16>>::Mask, fill: <Scalar as SimdKernel<I16>>::Vector, ) -> <Scalar as SimdKernel<I16>>::Vector

Expand: scatter the low lanes of src into result positions where mask[i]=1.

unsafe fn gather( base: *const I16, indices: <Scalar as SimdKernel<I16>>::IndexVector, ) -> <Scalar as SimdKernel<I16>>::Vector

Gather: load LANE_COUNT elements at base + indices[i] for each lane i.

unsafe fn gather_masked( base: *const I16, indices: <Scalar as SimdKernel<I16>>::IndexVector, mask: <Scalar as SimdKernel<I16>>::Mask, src: <Scalar as SimdKernel<I16>>::Vector, ) -> <Scalar as SimdKernel<I16>>::Vector

Masked gather: gather active lanes; inactive lanes take value from src.

unsafe fn mask_from_bools(bits: &[bool]) -> <Scalar as SimdKernel<I16>>::Mask

Construct a mask from a slice of booleans (length must equal LANE_COUNT).

unsafe fn leading_k_mask(k: usize) -> <Scalar as SimdKernel<I16>>::Mask

Construct a mask with the first k lanes active and the rest inactive.

unsafe fn zero() -> <Scalar as SimdKernel<I16>>::Vector

Set all lanes to zero.

unsafe fn splat(val: I16) -> <Scalar as SimdKernel<I16>>::Vector

Broadcast a scalar value to all lanes.

unsafe fn mask_to_bitmask(mask: <Scalar as SimdKernel<I16>>::Mask) -> u64

Convert the native mask back to a raw u64 bitmask.

unsafe fn mask_to_vector( mask: <Scalar as SimdKernel<I16>>::Mask, ) -> <Scalar as SimdKernel<I16>>::Vector

Convert the native mask back to a vector register where active lanes are set to T::ALL_ONES and inactive lanes to T::ZERO.

unsafe fn vector_to_mask( v: <Scalar as SimdKernel<I16>>::Vector, ) -> <Scalar as SimdKernel<I16>>::Mask

Convert a comparison-result vector into the native mask, the inverse of SimdKernel::mask_to_vector.

const LANE_BOUND_CHECK: () = _

Compile-time guard that LANE_COUNT fits the fixed MAX_SIMD_LANES scalar-fallback stack buffers. Referencing this const in the buffer-using default methods forces the assertion to be evaluated for each concrete backend at monomorphization, turning a would-be silent stack-buffer overflow into a compile error.

const SUPPORTS_NT_STORE: bool = false

Whether this backend provides a non-temporal (cache-bypassing) store via store_streaming. Backends leaving this false keep the regular store default; callers gate the streaming path on this const so it is a compile-time branch, dead-code-eliminated where unsupported.

unsafe fn store_streaming(ptr: *mut T, val: Self::Vector)

Store a vector with a non-temporal (streaming) hint that bypasses the cache, avoiding the read-for-ownership traffic a normal write-allocate pays for write-only data larger than the last-level cache (measured 1.71× on out-of-LLC AVX2 f32 elementwise writes; see streaming_bench).

fn stream_write_barrier()

Fence ordering this backend’s non-temporal stores before subsequent reads. No-op by default (only meaningful where store_streaming is a weakly ordered non-temporal store).

unsafe fn masked_load_unaligned( ptr: *const T, mask: Self::Mask, src: Self::Vector, ) -> Self::Vector

Masked load: active lanes loaded from ptr, inactive lanes taken from src.

unsafe fn masked_store_unaligned( ptr: *mut T, mask: Self::Mask, val: Self::Vector, )

Masked store: active lanes written to ptr, inactive lanes left unchanged.

unsafe fn masked_add( a: Self::Vector, b: Self::Vector, mask: Self::Mask, src: Self::Vector, ) -> Self::Vector

Masked elementwise add: active lanes compute a + b, inactive lanes yield src.

unsafe fn masked_mul( a: Self::Vector, b: Self::Vector, mask: Self::Mask, src: Self::Vector, ) -> Self::Vector

Masked elementwise multiply: active lanes compute a * b, inactive lanes yield src.

unsafe fn masked_fmadd( a: Self::Vector, b: Self::Vector, c: Self::Vector, mask: Self::Mask, ) -> Self::Vector

Masked fused multiply-add: active lanes compute (a * b) + c, inactive lanes retain c.

unsafe fn masked_sum_reduce(v: Self::Vector, mask: Self::Mask) -> T

Masked horizontal sum: only lanes where mask[i]=1 contribute.

unsafe fn mask_from_bitmask(bm: u64) -> Self::Mask

Convert a raw u64 bitmask to the architecture-native mask type.

unsafe fn scan_vector<Op, SMode>(v: Self::Vector, carry: T) -> (Self::Vector, T)

where Op: ScanOp<T>, SMode: ScanMode,

Perform an intra-vector prefix scan (inclusive or exclusive) of the vector, using the specified ScanOp strategy and starting carry value. Returns the scanned vector and the final carry value.

unsafe fn div(a: Self::Vector, b: Self::Vector) -> Self::Vector

Elementwise division: a / b.

unsafe fn bitand(a: Self::Vector, b: Self::Vector) -> Self::Vector

Elementwise bitwise AND: a & b.

unsafe fn bitor(a: Self::Vector, b: Self::Vector) -> Self::Vector

Elementwise bitwise OR: a | b.

unsafe fn bitxor(a: Self::Vector, b: Self::Vector) -> Self::Vector

Elementwise bitwise XOR: a ^ b.

unsafe fn abs(a: Self::Vector) -> Self::Vector

Elementwise absolute value.

unsafe fn min(a: Self::Vector, b: Self::Vector) -> Self::Vector

Elementwise minimum of a and b.

unsafe fn max(a: Self::Vector, b: Self::Vector) -> Self::Vector

Elementwise maximum of a and b.

unsafe fn sqrt(a: Self::Vector) -> Self::Vector

Elementwise square root.

unsafe fn recip_sqrt(a: Self::Vector) -> Self::Vector

Elementwise reciprocal square root, 1/√x, to full T precision (~1 ulp).

unsafe fn cmp_eq(a: Self::Vector, b: Self::Vector) -> Self::Vector

Elementwise equal: a == b.

unsafe fn cmp_ne(a: Self::Vector, b: Self::Vector) -> Self::Vector

Elementwise not equal: a != b.

unsafe fn cmp_lt(a: Self::Vector, b: Self::Vector) -> Self::Vector

Elementwise less than: a < b.

unsafe fn cmp_le(a: Self::Vector, b: Self::Vector) -> Self::Vector

Elementwise less than or equal: a <= b.

unsafe fn cmp_gt(a: Self::Vector, b: Self::Vector) -> Self::Vector

Elementwise greater than: a > b.

unsafe fn cmp_ge(a: Self::Vector, b: Self::Vector) -> Self::Vector

Elementwise greater than or equal: a >= b.

unsafe fn blend( mask: Self::Vector, true_val: Self::Vector, false_val: Self::Vector, ) -> Self::Vector

Elementwise blend: select lanes from true_val where the sign bit of mask is set, and from false_val otherwise.

unsafe fn bitnot(a: Self::Vector) -> Self::Vector

Elementwise bitwise NOT: !a.

unsafe fn min_reduce(v: Self::Vector) -> T

Horizontal minimum across all lanes.

unsafe fn max_reduce(v: Self::Vector) -> T

Horizontal maximum across all lanes.

unsafe fn popcount(a: Self::Vector) -> Self::Vector

Elementwise population count (number of set bits).

unsafe fn horizontal_bitwise_and(v: Self::Vector) -> T

Horizontal bitwise AND across all lanes.

unsafe fn horizontal_bitwise_or(v: Self::Vector) -> T

Horizontal bitwise OR across all lanes.

unsafe fn horizontal_bitwise_xor(v: Self::Vector) -> T

Horizontal bitwise XOR across all lanes.

unsafe fn swap_adjacent(v: Self::Vector) -> Self::Vector

Swap each adjacent lane pair: [a0, a1, a2, a3, ...] -> [a1, a0, a3, a2, ...].

unsafe fn dup_even(v: Self::Vector) -> Self::Vector

Duplicate even lanes into odd lanes: [a0, a1, a2, a3, ...] -> [a0, a0, a2, a2, ...].

unsafe fn dup_odd(v: Self::Vector) -> Self::Vector

Duplicate odd lanes into even lanes: [a0, a1, a2, a3, ...] -> [a1, a1, a3, a3, ...].

unsafe fn fmaddsub( a: Self::Vector, b: Self::Vector, c: Self::Vector, ) -> Self::Vector

Alternating fused multiply: even lanes a*b - c, odd lanes a*b + c.

unsafe fn fmsubadd( a: Self::Vector, b: Self::Vector, c: Self::Vector, ) -> Self::Vector

Alternating fused multiply: even lanes a*b + c, odd lanes a*b - c.

impl SimdKernel<I16> for Avx2

Available on x86 or x86-64 only.

const LANE_COUNT: usize = 16

Number of primitive elements of type T in one Vector.

const UNROLL_FACTOR: usize = 4

Loop unrolling register accumulation factor to break loop-carried dependency chains.

type Vector = [I16; 16]

The underlying raw register/vector type for this architecture and element type.

type Mask = [bool; 16]

Hardware-native mask type.

type IndexVector = [i32; 16]

Integer index vector for gather operations.

unsafe fn load_aligned(ptr: *const I16) -> <Avx2 as SimdKernel<I16>>::Vector

Load a vector from an aligned pointer.

unsafe fn load_unaligned(ptr: *const I16) -> <Avx2 as SimdKernel<I16>>::Vector

Load a vector from an unaligned pointer.

unsafe fn store_aligned(ptr: *mut I16, val: <Avx2 as SimdKernel<I16>>::Vector)

Store a vector to an aligned pointer.

unsafe fn store_unaligned(ptr: *mut I16, val: <Avx2 as SimdKernel<I16>>::Vector)

Store a vector to an unaligned pointer.

unsafe fn add( a: <Avx2 as SimdKernel<I16>>::Vector, b: <Avx2 as SimdKernel<I16>>::Vector, ) -> <Avx2 as SimdKernel<I16>>::Vector

Elementwise addition: a + b.

unsafe fn mul( a: <Avx2 as SimdKernel<I16>>::Vector, b: <Avx2 as SimdKernel<I16>>::Vector, ) -> <Avx2 as SimdKernel<I16>>::Vector

Elementwise multiplication: a * b.

unsafe fn sub( a: <Avx2 as SimdKernel<I16>>::Vector, b: <Avx2 as SimdKernel<I16>>::Vector, ) -> <Avx2 as SimdKernel<I16>>::Vector

Elementwise subtraction: a - b.

unsafe fn neg( a: <Avx2 as SimdKernel<I16>>::Vector, ) -> <Avx2 as SimdKernel<I16>>::Vector

Elementwise negate: -a.

unsafe fn fmadd( a: <Avx2 as SimdKernel<I16>>::Vector, b: <Avx2 as SimdKernel<I16>>::Vector, c: <Avx2 as SimdKernel<I16>>::Vector, ) -> <Avx2 as SimdKernel<I16>>::Vector

Fused multiply-add: (a * b) + c.

unsafe fn sum_reduce(v: <Avx2 as SimdKernel<I16>>::Vector) -> I16

Horizontal sum of all lanes.

unsafe fn compress( src: <Avx2 as SimdKernel<I16>>::Vector, mask: <Avx2 as SimdKernel<I16>>::Mask, ) -> <Avx2 as SimdKernel<I16>>::Vector

Compress: pack selected lanes (where mask[i]=1) into the low lanes of the result.

unsafe fn expand( src: <Avx2 as SimdKernel<I16>>::Vector, mask: <Avx2 as SimdKernel<I16>>::Mask, fill: <Avx2 as SimdKernel<I16>>::Vector, ) -> <Avx2 as SimdKernel<I16>>::Vector

Expand: scatter the low lanes of src into result positions where mask[i]=1.

unsafe fn gather( base: *const I16, indices: <Avx2 as SimdKernel<I16>>::IndexVector, ) -> <Avx2 as SimdKernel<I16>>::Vector

Gather: load LANE_COUNT elements at base + indices[i] for each lane i.

unsafe fn gather_masked( base: *const I16, indices: <Avx2 as SimdKernel<I16>>::IndexVector, mask: <Avx2 as SimdKernel<I16>>::Mask, src: <Avx2 as SimdKernel<I16>>::Vector, ) -> <Avx2 as SimdKernel<I16>>::Vector

Masked gather: gather active lanes; inactive lanes take value from src.

unsafe fn mask_from_bools(bits: &[bool]) -> <Avx2 as SimdKernel<I16>>::Mask

Construct a mask from a slice of booleans (length must equal LANE_COUNT).

unsafe fn leading_k_mask(k: usize) -> <Avx2 as SimdKernel<I16>>::Mask

Construct a mask with the first k lanes active and the rest inactive.

unsafe fn zero() -> <Avx2 as SimdKernel<I16>>::Vector

Set all lanes to zero.

unsafe fn splat(val: I16) -> <Avx2 as SimdKernel<I16>>::Vector

Broadcast a scalar value to all lanes.

unsafe fn mask_to_bitmask(mask: <Avx2 as SimdKernel<I16>>::Mask) -> u64

Convert the native mask back to a raw u64 bitmask.

unsafe fn mask_to_vector( mask: <Avx2 as SimdKernel<I16>>::Mask, ) -> <Avx2 as SimdKernel<I16>>::Vector

Convert the native mask back to a vector register where active lanes are set to T::ALL_ONES and inactive lanes to T::ZERO.

unsafe fn vector_to_mask( v: <Avx2 as SimdKernel<I16>>::Vector, ) -> <Avx2 as SimdKernel<I16>>::Mask

Convert a comparison-result vector into the native mask, the inverse of SimdKernel::mask_to_vector.

const LANE_BOUND_CHECK: () = _

Compile-time guard that LANE_COUNT fits the fixed MAX_SIMD_LANES scalar-fallback stack buffers. Referencing this const in the buffer-using default methods forces the assertion to be evaluated for each concrete backend at monomorphization, turning a would-be silent stack-buffer overflow into a compile error.

const SUPPORTS_NT_STORE: bool = false

Whether this backend provides a non-temporal (cache-bypassing) store via store_streaming. Backends leaving this false keep the regular store default; callers gate the streaming path on this const so it is a compile-time branch, dead-code-eliminated where unsupported.

unsafe fn store_streaming(ptr: *mut T, val: Self::Vector)

Store a vector with a non-temporal (streaming) hint that bypasses the cache, avoiding the read-for-ownership traffic a normal write-allocate pays for write-only data larger than the last-level cache (measured 1.71× on out-of-LLC AVX2 f32 elementwise writes; see streaming_bench).

fn stream_write_barrier()

Fence ordering this backend’s non-temporal stores before subsequent reads. No-op by default (only meaningful where store_streaming is a weakly ordered non-temporal store).

unsafe fn masked_load_unaligned( ptr: *const T, mask: Self::Mask, src: Self::Vector, ) -> Self::Vector

Masked load: active lanes loaded from ptr, inactive lanes taken from src.

unsafe fn masked_store_unaligned( ptr: *mut T, mask: Self::Mask, val: Self::Vector, )

Masked store: active lanes written to ptr, inactive lanes left unchanged.

unsafe fn masked_add( a: Self::Vector, b: Self::Vector, mask: Self::Mask, src: Self::Vector, ) -> Self::Vector

Masked elementwise add: active lanes compute a + b, inactive lanes yield src.

unsafe fn masked_mul( a: Self::Vector, b: Self::Vector, mask: Self::Mask, src: Self::Vector, ) -> Self::Vector

Masked elementwise multiply: active lanes compute a * b, inactive lanes yield src.

unsafe fn masked_fmadd( a: Self::Vector, b: Self::Vector, c: Self::Vector, mask: Self::Mask, ) -> Self::Vector

Masked fused multiply-add: active lanes compute (a * b) + c, inactive lanes retain c.

unsafe fn masked_sum_reduce(v: Self::Vector, mask: Self::Mask) -> T

Masked horizontal sum: only lanes where mask[i]=1 contribute.

unsafe fn mask_from_bitmask(bm: u64) -> Self::Mask

Convert a raw u64 bitmask to the architecture-native mask type.

unsafe fn scan_vector<Op, SMode>(v: Self::Vector, carry: T) -> (Self::Vector, T)

where Op: ScanOp<T>, SMode: ScanMode,

Perform an intra-vector prefix scan (inclusive or exclusive) of the vector, using the specified ScanOp strategy and starting carry value. Returns the scanned vector and the final carry value.

unsafe fn div(a: Self::Vector, b: Self::Vector) -> Self::Vector

Elementwise division: a / b.

unsafe fn bitand(a: Self::Vector, b: Self::Vector) -> Self::Vector

Elementwise bitwise AND: a & b.

unsafe fn bitor(a: Self::Vector, b: Self::Vector) -> Self::Vector

Elementwise bitwise OR: a | b.

unsafe fn bitxor(a: Self::Vector, b: Self::Vector) -> Self::Vector

Elementwise bitwise XOR: a ^ b.

unsafe fn abs(a: Self::Vector) -> Self::Vector

Elementwise absolute value.

unsafe fn min(a: Self::Vector, b: Self::Vector) -> Self::Vector

Elementwise minimum of a and b.

unsafe fn max(a: Self::Vector, b: Self::Vector) -> Self::Vector

Elementwise maximum of a and b.

unsafe fn sqrt(a: Self::Vector) -> Self::Vector

Elementwise square root.

unsafe fn recip_sqrt(a: Self::Vector) -> Self::Vector

Elementwise reciprocal square root, 1/√x, to full T precision (~1 ulp).

unsafe fn cmp_eq(a: Self::Vector, b: Self::Vector) -> Self::Vector

Elementwise equal: a == b.

unsafe fn cmp_ne(a: Self::Vector, b: Self::Vector) -> Self::Vector

Elementwise not equal: a != b.

unsafe fn cmp_lt(a: Self::Vector, b: Self::Vector) -> Self::Vector

Elementwise less than: a < b.

unsafe fn cmp_le(a: Self::Vector, b: Self::Vector) -> Self::Vector

Elementwise less than or equal: a <= b.

unsafe fn cmp_gt(a: Self::Vector, b: Self::Vector) -> Self::Vector

Elementwise greater than: a > b.

unsafe fn cmp_ge(a: Self::Vector, b: Self::Vector) -> Self::Vector

Elementwise greater than or equal: a >= b.

unsafe fn blend( mask: Self::Vector, true_val: Self::Vector, false_val: Self::Vector, ) -> Self::Vector

Elementwise blend: select lanes from true_val where the sign bit of mask is set, and from false_val otherwise.

unsafe fn bitnot(a: Self::Vector) -> Self::Vector

Elementwise bitwise NOT: !a.

unsafe fn min_reduce(v: Self::Vector) -> T

Horizontal minimum across all lanes.

unsafe fn max_reduce(v: Self::Vector) -> T

Horizontal maximum across all lanes.

unsafe fn popcount(a: Self::Vector) -> Self::Vector

Elementwise population count (number of set bits).

unsafe fn horizontal_bitwise_and(v: Self::Vector) -> T

Horizontal bitwise AND across all lanes.

unsafe fn horizontal_bitwise_or(v: Self::Vector) -> T

Horizontal bitwise OR across all lanes.

unsafe fn horizontal_bitwise_xor(v: Self::Vector) -> T

Horizontal bitwise XOR across all lanes.

unsafe fn swap_adjacent(v: Self::Vector) -> Self::Vector

Swap each adjacent lane pair: [a0, a1, a2, a3, ...] -> [a1, a0, a3, a2, ...].

unsafe fn dup_even(v: Self::Vector) -> Self::Vector

Duplicate even lanes into odd lanes: [a0, a1, a2, a3, ...] -> [a0, a0, a2, a2, ...].

unsafe fn dup_odd(v: Self::Vector) -> Self::Vector

Duplicate odd lanes into even lanes: [a0, a1, a2, a3, ...] -> [a1, a1, a3, a3, ...].

unsafe fn fmaddsub( a: Self::Vector, b: Self::Vector, c: Self::Vector, ) -> Self::Vector

Alternating fused multiply: even lanes a*b - c, odd lanes a*b + c.

unsafe fn fmsubadd( a: Self::Vector, b: Self::Vector, c: Self::Vector, ) -> Self::Vector

Alternating fused multiply: even lanes a*b + c, odd lanes a*b - c.

impl SimdKernel<I16> for Avx512

Available on x86 or x86-64 only.

const LANE_COUNT: usize = 32

Number of primitive elements of type T in one Vector.

const UNROLL_FACTOR: usize = 4

Loop unrolling register accumulation factor to break loop-carried dependency chains.

type Vector = [I16; 32]

The underlying raw register/vector type for this architecture and element type.

type Mask = [bool; 32]

Hardware-native mask type.

type IndexVector = [i32; 32]

Integer index vector for gather operations.

unsafe fn load_aligned(ptr: *const I16) -> <Avx512 as SimdKernel<I16>>::Vector

Load a vector from an aligned pointer.

unsafe fn load_unaligned(ptr: *const I16) -> <Avx512 as SimdKernel<I16>>::Vector

Load a vector from an unaligned pointer.

unsafe fn store_aligned(ptr: *mut I16, val: <Avx512 as SimdKernel<I16>>::Vector)

Store a vector to an aligned pointer.

unsafe fn store_unaligned( ptr: *mut I16, val: <Avx512 as SimdKernel<I16>>::Vector, )

Store a vector to an unaligned pointer.

unsafe fn add( a: <Avx512 as SimdKernel<I16>>::Vector, b: <Avx512 as SimdKernel<I16>>::Vector, ) -> <Avx512 as SimdKernel<I16>>::Vector

Elementwise addition: a + b.

unsafe fn mul( a: <Avx512 as SimdKernel<I16>>::Vector, b: <Avx512 as SimdKernel<I16>>::Vector, ) -> <Avx512 as SimdKernel<I16>>::Vector

Elementwise multiplication: a * b.

unsafe fn sub( a: <Avx512 as SimdKernel<I16>>::Vector, b: <Avx512 as SimdKernel<I16>>::Vector, ) -> <Avx512 as SimdKernel<I16>>::Vector

Elementwise subtraction: a - b.

unsafe fn neg( a: <Avx512 as SimdKernel<I16>>::Vector, ) -> <Avx512 as SimdKernel<I16>>::Vector

Elementwise negate: -a.

unsafe fn fmadd( a: <Avx512 as SimdKernel<I16>>::Vector, b: <Avx512 as SimdKernel<I16>>::Vector, c: <Avx512 as SimdKernel<I16>>::Vector, ) -> <Avx512 as SimdKernel<I16>>::Vector

Fused multiply-add: (a * b) + c.

unsafe fn sum_reduce(v: <Avx512 as SimdKernel<I16>>::Vector) -> I16

Horizontal sum of all lanes.

unsafe fn compress( src: <Avx512 as SimdKernel<I16>>::Vector, mask: <Avx512 as SimdKernel<I16>>::Mask, ) -> <Avx512 as SimdKernel<I16>>::Vector

Compress: pack selected lanes (where mask[i]=1) into the low lanes of the result.

unsafe fn expand( src: <Avx512 as SimdKernel<I16>>::Vector, mask: <Avx512 as SimdKernel<I16>>::Mask, fill: <Avx512 as SimdKernel<I16>>::Vector, ) -> <Avx512 as SimdKernel<I16>>::Vector

Expand: scatter the low lanes of src into result positions where mask[i]=1.

unsafe fn gather( base: *const I16, indices: <Avx512 as SimdKernel<I16>>::IndexVector, ) -> <Avx512 as SimdKernel<I16>>::Vector

Gather: load LANE_COUNT elements at base + indices[i] for each lane i.

unsafe fn gather_masked( base: *const I16, indices: <Avx512 as SimdKernel<I16>>::IndexVector, mask: <Avx512 as SimdKernel<I16>>::Mask, src: <Avx512 as SimdKernel<I16>>::Vector, ) -> <Avx512 as SimdKernel<I16>>::Vector

Masked gather: gather active lanes; inactive lanes take value from src.

unsafe fn mask_from_bools(bits: &[bool]) -> <Avx512 as SimdKernel<I16>>::Mask

Construct a mask from a slice of booleans (length must equal LANE_COUNT).

unsafe fn leading_k_mask(k: usize) -> <Avx512 as SimdKernel<I16>>::Mask

Construct a mask with the first k lanes active and the rest inactive.

unsafe fn zero() -> <Avx512 as SimdKernel<I16>>::Vector

Set all lanes to zero.

unsafe fn splat(val: I16) -> <Avx512 as SimdKernel<I16>>::Vector

Broadcast a scalar value to all lanes.

unsafe fn mask_to_bitmask(mask: <Avx512 as SimdKernel<I16>>::Mask) -> u64

Convert the native mask back to a raw u64 bitmask.

unsafe fn mask_to_vector( mask: <Avx512 as SimdKernel<I16>>::Mask, ) -> <Avx512 as SimdKernel<I16>>::Vector

Convert the native mask back to a vector register where active lanes are set to T::ALL_ONES and inactive lanes to T::ZERO.

unsafe fn vector_to_mask( v: <Avx512 as SimdKernel<I16>>::Vector, ) -> <Avx512 as SimdKernel<I16>>::Mask

Convert a comparison-result vector into the native mask, the inverse of SimdKernel::mask_to_vector.

const LANE_BOUND_CHECK: () = _

Compile-time guard that LANE_COUNT fits the fixed MAX_SIMD_LANES scalar-fallback stack buffers. Referencing this const in the buffer-using default methods forces the assertion to be evaluated for each concrete backend at monomorphization, turning a would-be silent stack-buffer overflow into a compile error.

const SUPPORTS_NT_STORE: bool = false

Whether this backend provides a non-temporal (cache-bypassing) store via store_streaming. Backends leaving this false keep the regular store default; callers gate the streaming path on this const so it is a compile-time branch, dead-code-eliminated where unsupported.

unsafe fn store_streaming(ptr: *mut T, val: Self::Vector)

Store a vector with a non-temporal (streaming) hint that bypasses the cache, avoiding the read-for-ownership traffic a normal write-allocate pays for write-only data larger than the last-level cache (measured 1.71× on out-of-LLC AVX2 f32 elementwise writes; see streaming_bench).

fn stream_write_barrier()

Fence ordering this backend’s non-temporal stores before subsequent reads. No-op by default (only meaningful where store_streaming is a weakly ordered non-temporal store).

unsafe fn masked_load_unaligned( ptr: *const T, mask: Self::Mask, src: Self::Vector, ) -> Self::Vector

Masked load: active lanes loaded from ptr, inactive lanes taken from src.

unsafe fn masked_store_unaligned( ptr: *mut T, mask: Self::Mask, val: Self::Vector, )

Masked store: active lanes written to ptr, inactive lanes left unchanged.

unsafe fn masked_add( a: Self::Vector, b: Self::Vector, mask: Self::Mask, src: Self::Vector, ) -> Self::Vector

Masked elementwise add: active lanes compute a + b, inactive lanes yield src.

unsafe fn masked_mul( a: Self::Vector, b: Self::Vector, mask: Self::Mask, src: Self::Vector, ) -> Self::Vector

Masked elementwise multiply: active lanes compute a * b, inactive lanes yield src.

unsafe fn masked_fmadd( a: Self::Vector, b: Self::Vector, c: Self::Vector, mask: Self::Mask, ) -> Self::Vector

Masked fused multiply-add: active lanes compute (a * b) + c, inactive lanes retain c.

unsafe fn masked_sum_reduce(v: Self::Vector, mask: Self::Mask) -> T

Masked horizontal sum: only lanes where mask[i]=1 contribute.

unsafe fn mask_from_bitmask(bm: u64) -> Self::Mask

Convert a raw u64 bitmask to the architecture-native mask type.

unsafe fn scan_vector<Op, SMode>(v: Self::Vector, carry: T) -> (Self::Vector, T)

where Op: ScanOp<T>, SMode: ScanMode,

Perform an intra-vector prefix scan (inclusive or exclusive) of the vector, using the specified ScanOp strategy and starting carry value. Returns the scanned vector and the final carry value.

unsafe fn div(a: Self::Vector, b: Self::Vector) -> Self::Vector

Elementwise division: a / b.

unsafe fn bitand(a: Self::Vector, b: Self::Vector) -> Self::Vector

Elementwise bitwise AND: a & b.

unsafe fn bitor(a: Self::Vector, b: Self::Vector) -> Self::Vector

Elementwise bitwise OR: a | b.

unsafe fn bitxor(a: Self::Vector, b: Self::Vector) -> Self::Vector

Elementwise bitwise XOR: a ^ b.

unsafe fn abs(a: Self::Vector) -> Self::Vector

Elementwise absolute value.

unsafe fn min(a: Self::Vector, b: Self::Vector) -> Self::Vector

Elementwise minimum of a and b.

unsafe fn max(a: Self::Vector, b: Self::Vector) -> Self::Vector

Elementwise maximum of a and b.

unsafe fn sqrt(a: Self::Vector) -> Self::Vector

Elementwise square root.

unsafe fn recip_sqrt(a: Self::Vector) -> Self::Vector

Elementwise reciprocal square root, 1/√x, to full T precision (~1 ulp).

unsafe fn cmp_eq(a: Self::Vector, b: Self::Vector) -> Self::Vector

Elementwise equal: a == b.

unsafe fn cmp_ne(a: Self::Vector, b: Self::Vector) -> Self::Vector

Elementwise not equal: a != b.

unsafe fn cmp_lt(a: Self::Vector, b: Self::Vector) -> Self::Vector

Elementwise less than: a < b.

unsafe fn cmp_le(a: Self::Vector, b: Self::Vector) -> Self::Vector

Elementwise less than or equal: a <= b.

unsafe fn cmp_gt(a: Self::Vector, b: Self::Vector) -> Self::Vector

Elementwise greater than: a > b.

unsafe fn cmp_ge(a: Self::Vector, b: Self::Vector) -> Self::Vector

Elementwise greater than or equal: a >= b.

unsafe fn blend( mask: Self::Vector, true_val: Self::Vector, false_val: Self::Vector, ) -> Self::Vector

Elementwise blend: select lanes from true_val where the sign bit of mask is set, and from false_val otherwise.

unsafe fn bitnot(a: Self::Vector) -> Self::Vector

Elementwise bitwise NOT: !a.

unsafe fn min_reduce(v: Self::Vector) -> T

Horizontal minimum across all lanes.

unsafe fn max_reduce(v: Self::Vector) -> T

Horizontal maximum across all lanes.

unsafe fn popcount(a: Self::Vector) -> Self::Vector

Elementwise population count (number of set bits).

unsafe fn horizontal_bitwise_and(v: Self::Vector) -> T

Horizontal bitwise AND across all lanes.

unsafe fn horizontal_bitwise_or(v: Self::Vector) -> T

Horizontal bitwise OR across all lanes.

unsafe fn horizontal_bitwise_xor(v: Self::Vector) -> T

Horizontal bitwise XOR across all lanes.

unsafe fn swap_adjacent(v: Self::Vector) -> Self::Vector

Swap each adjacent lane pair: [a0, a1, a2, a3, ...] -> [a1, a0, a3, a2, ...].

unsafe fn dup_even(v: Self::Vector) -> Self::Vector

Duplicate even lanes into odd lanes: [a0, a1, a2, a3, ...] -> [a0, a0, a2, a2, ...].

unsafe fn dup_odd(v: Self::Vector) -> Self::Vector

Duplicate odd lanes into even lanes: [a0, a1, a2, a3, ...] -> [a1, a1, a3, a3, ...].

unsafe fn fmaddsub( a: Self::Vector, b: Self::Vector, c: Self::Vector, ) -> Self::Vector

Alternating fused multiply: even lanes a*b - c, odd lanes a*b + c.

unsafe fn fmsubadd( a: Self::Vector, b: Self::Vector, c: Self::Vector, ) -> Self::Vector

Alternating fused multiply: even lanes a*b + c, odd lanes a*b - c.

impl StructuralPartialEq for I16

impl Sub for I16

type Output = I16

The resulting type after applying the - operator.

fn sub(self, rhs: I16) -> I16

Performs the - operation.

impl SubAssign for I16

fn sub_assign(&mut self, rhs: I16)

Performs the -= operation.

impl Zeroable for I16

fn zeroed() -> Self

Returns a value of Self with every byte set to zero.

impl Zeroable for I16

fn zeroed() -> Self

Calls zeroed.