Struct i8x32 

pub struct i8x32<S: Simd> {
    pub simd: S,
    /* private fields */
}

A SIMD vector of 32 i8 elements.

This type’s memory layout is identical to that of [i8; 32], except that it is aligned to 32 bytes.

You may construct this vector type using the Self::splat, Self::from_slice, Self::simd_from, Self::from_fn, and Self::block_splat methods.

fn construct_simd<S: Simd>(simd: S) {
    // From a single scalar value:
    let a = i8x32::splat(simd, 1);
    let b = i8x32::simd_from(simd, 1);

    // From a slice:
    let c = i8x32::from_slice(simd, &[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]);

    // From an array:
    let d = i8x32::simd_from(simd, [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]);

    // From an element-wise function:
    let e = i8x32::from_fn(simd, |i| i as i8);
    // From `Self::Block`:
    let f = i8x32::block_splat(i8x16::simd_from(simd, [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16]));
}

Fields

simd: S

Trait Implementations

impl<S: Simd> Add for i8x32<S>

fn add(self, rhs: Self) -> Self::Output

Add two vectors element-wise, wrapping on overflow.

type Output = i8x32<S>

The resulting type after applying the + operator.

impl<S: Simd> Add<i8> for i8x32<S>

type Output = i8x32<S>

The resulting type after applying the + operator.

fn add(self, rhs: i8) -> Self::Output

Performs the + operation.

impl<S: Simd> Add<i8x32<S>> for i8

type Output = i8x32<S>

The resulting type after applying the + operator.

fn add(self, rhs: i8x32<S>) -> Self::Output

Performs the + operation.

impl<S: Simd> AddAssign for i8x32<S>

fn add_assign(&mut self, rhs: Self)

Add two vectors element-wise, wrapping on overflow.

impl<S: Simd> AddAssign<i8> for i8x32<S>

fn add_assign(&mut self, rhs: i8)

Performs the += operation.

impl<S: Simd> BitAnd for i8x32<S>

fn bitand(self, rhs: Self) -> Self::Output

Compute the bitwise AND of two vectors.

type Output = i8x32<S>

The resulting type after applying the & operator.

impl<S: Simd> BitAnd<i8> for i8x32<S>

type Output = i8x32<S>

The resulting type after applying the & operator.

fn bitand(self, rhs: i8) -> Self::Output

Performs the & operation.

impl<S: Simd> BitAnd<i8x32<S>> for i8

type Output = i8x32<S>

The resulting type after applying the & operator.

fn bitand(self, rhs: i8x32<S>) -> Self::Output

Performs the & operation.

impl<S: Simd> BitAndAssign for i8x32<S>

fn bitand_assign(&mut self, rhs: Self)

Compute the bitwise AND of two vectors.

impl<S: Simd> BitAndAssign<i8> for i8x32<S>

fn bitand_assign(&mut self, rhs: i8)

Performs the &= operation.

impl<S: Simd> BitOr for i8x32<S>

fn bitor(self, rhs: Self) -> Self::Output

Compute the bitwise OR of two vectors.

type Output = i8x32<S>

The resulting type after applying the | operator.

impl<S: Simd> BitOr<i8> for i8x32<S>

type Output = i8x32<S>

The resulting type after applying the | operator.

fn bitor(self, rhs: i8) -> Self::Output

Performs the | operation.

impl<S: Simd> BitOr<i8x32<S>> for i8

type Output = i8x32<S>

The resulting type after applying the | operator.

fn bitor(self, rhs: i8x32<S>) -> Self::Output

Performs the | operation.

impl<S: Simd> BitOrAssign for i8x32<S>

fn bitor_assign(&mut self, rhs: Self)

Compute the bitwise OR of two vectors.

impl<S: Simd> BitOrAssign<i8> for i8x32<S>

fn bitor_assign(&mut self, rhs: i8)

Performs the |= operation.

impl<S: Simd> BitXor for i8x32<S>

fn bitxor(self, rhs: Self) -> Self::Output

Compute the bitwise XOR of two vectors.

type Output = i8x32<S>

The resulting type after applying the ^ operator.

impl<S: Simd> BitXor<i8> for i8x32<S>

type Output = i8x32<S>

The resulting type after applying the ^ operator.

fn bitxor(self, rhs: i8) -> Self::Output

Performs the ^ operation.

impl<S: Simd> BitXor<i8x32<S>> for i8

type Output = i8x32<S>

The resulting type after applying the ^ operator.

fn bitxor(self, rhs: i8x32<S>) -> Self::Output

Performs the ^ operation.

impl<S: Simd> BitXorAssign for i8x32<S>

fn bitxor_assign(&mut self, rhs: Self)

Compute the bitwise XOR of two vectors.

impl<S: Simd> BitXorAssign<i8> for i8x32<S>

fn bitxor_assign(&mut self, rhs: i8)

Performs the ^= operation.

impl<S: Simd> Bytes for i8x32<S>

type Bytes = u8x32<S>

The same-width SIMD vector of u8 lanes used as the byte representation.

fn to_bytes(self) -> Self::Bytes

Reinterpret this vector as a same-width vector of u8 lanes.

fn from_bytes(value: Self::Bytes) -> Self

Reinterpret a same-width vector of u8 lanes as this vector type.

fn bitcast<U: Bytes<Bytes = Self::Bytes>>(self) -> U

Bitcast directly to another SIMD vector with the same byte representation. This is effectively a safe transmute for SIMD types.

impl<S: Clone + Simd> Clone for i8x32<S>

where S::i8x32: Clone,

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<S: Copy + Simd> Copy for i8x32<S>

where S::i8x32: Copy,

impl<S: Simd + Debug> Debug for i8x32<S>

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

Formats the value using the given formatter.

impl<S: Simd> Deref for i8x32<S>

type Target = [i8; 32]

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<S: Simd> DerefMut for i8x32<S>

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl<S: Simd> ExtractToken for i8x32<S>

type S = S

The SIMD implementation associated with this value.

fn token(&self) -> S

Get the SIMD token associated with this value.

impl<S: Simd> From<i8x32<S>> for __m256i

Available on x86 or x86-64 only.

fn from(value: i8x32<S>) -> Self

Converts to this type from the input type.

impl<S: Simd> From<i8x32<S>> for [i8; 32]

fn from(value: i8x32<S>) -> Self

Converts to this type from the input type.

impl<S: Simd> Index<usize> for i8x32<S>

type Output = i8

The returned type after indexing.

fn index(&self, i: usize) -> &Self::Output

Performs the indexing (container[index]) operation.

impl<S: Simd> IndexMut<usize> for i8x32<S>

fn index_mut(&mut self, i: usize) -> &mut Self::Output

Performs the mutable indexing (container[index]) operation.

impl<S: Simd> Mul for i8x32<S>

fn mul(self, rhs: Self) -> Self::Output

Multiply two vectors element-wise, wrapping on overflow.

type Output = i8x32<S>

The resulting type after applying the * operator.

impl<S: Simd> Mul<i8> for i8x32<S>

type Output = i8x32<S>

The resulting type after applying the * operator.

fn mul(self, rhs: i8) -> Self::Output

Performs the * operation.

impl<S: Simd> Mul<i8x32<S>> for i8

type Output = i8x32<S>

The resulting type after applying the * operator.

fn mul(self, rhs: i8x32<S>) -> Self::Output

Performs the * operation.

impl<S: Simd> MulAssign for i8x32<S>

fn mul_assign(&mut self, rhs: Self)

Multiply two vectors element-wise, wrapping on overflow.

impl<S: Simd> MulAssign<i8> for i8x32<S>

fn mul_assign(&mut self, rhs: i8)

Performs the *= operation.

impl<S: Simd> Neg for i8x32<S>

fn neg(self) -> Self::Output

Negate each element of the vector, wrapping on overflow.

type Output = i8x32<S>

The resulting type after applying the - operator.

impl<S: Simd> Not for i8x32<S>

fn not(self) -> Self::Output

Compute the bitwise NOT of the vector.

type Output = i8x32<S>

The resulting type after applying the ! operator.

impl<S: Simd> Select<i8x32<S>> for mask8x32<S>

fn select(self, if_true: i8x32<S>, if_false: i8x32<S>) -> i8x32<S>

For each logical lane of this mask, select the first operand if the lane is true, and select the second operand if the lane is false.

impl<S: Simd> Shl for i8x32<S>

fn shl(self, rhs: Self) -> Self::Output

Shift each element left by the given number of bits.

Bits shifted out of the left side are discarded, and zeros are shifted in on the right.

When shifting out of bounds (e.g. shifting a 32-bit value by 32 or more), the result is implementation-defined and may vary by platform.

Performance

This per-lane shift is slower than shifting the entire vector by a scalar. It is not vectorized at all on WebAssembly, SSE4.2, and for u8 and i8 elements on AVX2. Prefer shifting by a single scalar value instead of by a vector whenever possible.

type Output = i8x32<S>

The resulting type after applying the << operator.

impl<S: Simd> Shl<u32> for i8x32<S>

fn shl(self, rhs: u32) -> Self::Output

Shift each element left by the given number of bits.

Bits shifted out of the left side are discarded, and zeros are shifted in on the right.

When shifting out of bounds (e.g. shifting a 32-bit value by 32 or more), the result is implementation-defined and may vary by platform.

type Output = i8x32<S>

The resulting type after applying the << operator.

impl<S: Simd> ShlAssign for i8x32<S>

fn shl_assign(&mut self, rhs: Self)

Shift each element left by the given number of bits.

Bits shifted out of the left side are discarded, and zeros are shifted in on the right.

When shifting out of bounds (e.g. shifting a 32-bit value by 32 or more), the result is implementation-defined and may vary by platform.

Performance

This per-lane shift is slower than shifting the entire vector by a scalar. It is not vectorized at all on WebAssembly, SSE4.2, and for u8 and i8 elements on AVX2. Prefer shifting by a single scalar value instead of by a vector whenever possible.

impl<S: Simd> ShlAssign<u32> for i8x32<S>

fn shl_assign(&mut self, rhs: u32)

Performs the <<= operation.

impl<S: Simd> Shr for i8x32<S>

fn shr(self, rhs: Self) -> Self::Output

Shift each element right by the corresponding element in another vector.

For unsigned integers, zeros are shifted in on the left. For signed integers, the sign bit is replicated.

When shifting out of bounds (e.g. shifting a 32-bit value by 32 or more), the result is implementation-defined and may vary by platform.

Performance

This per-lane shift is slower than shifting the entire vector by a scalar. It is not vectorized at all on WebAssembly, SSE4.2, and for u8 and i8 elements on AVX2. Prefer shifting by a single scalar value instead of by a vector whenever possible.

type Output = i8x32<S>

The resulting type after applying the >> operator.

impl<S: Simd> Shr<u32> for i8x32<S>

fn shr(self, rhs: u32) -> Self::Output

Shift each element right by the given number of bits.

For unsigned integers, zeros are shifted in on the left. For signed integers, the sign bit is replicated.

When shifting out of bounds (e.g. shifting a 32-bit value by 32 or more), the result is implementation-defined and may vary by platform.

type Output = i8x32<S>

The resulting type after applying the >> operator.

impl<S: Simd> ShrAssign for i8x32<S>

fn shr_assign(&mut self, rhs: Self)

Shift each element right by the corresponding element in another vector.

For unsigned integers, zeros are shifted in on the left. For signed integers, the sign bit is replicated.

When shifting out of bounds (e.g. shifting a 32-bit value by 32 or more), the result is implementation-defined and may vary by platform.

Performance

This per-lane shift is slower than shifting the entire vector by a scalar. It is not vectorized at all on WebAssembly, SSE4.2, and for u8 and i8 elements on AVX2. Prefer shifting by a single scalar value instead of by a vector whenever possible.

impl<S: Simd> ShrAssign<u32> for i8x32<S>

fn shr_assign(&mut self, rhs: u32)

Performs the >>= operation.

impl<S: Simd> SimdBase<S> for i8x32<S>

const LEN: usize = 32

This vector type’s lane count. This is useful when you’re working with a native-width vector (e.g. Simd::f32s) and want to process data in native-width chunks.

type Element = i8

The type of this vector’s elements.

type ByteVector = u8x32<S>

The same-width SIMD vector of u8 lanes used as the byte representation.

type Mask = mask8x32<S>

A SIMD vector mask with the same number of logical lanes.

type Block = i8x16<S>

A 128-bit SIMD vector of the same scalar type.

type Array = [i8; 32]

The array type that this vector type corresponds to, which will always be [Self::Element; Self::LEN]. It has the same layout as this vector type, but likely has a lower alignment.

fn as_slice(&self) -> &[i8]

fn as_mut_slice(&mut self) -> &mut [i8]

fn from_slice(simd: S, slice: &[i8]) -> Self

Create a SIMD vector from a slice.

fn store_slice(&self, slice: &mut [i8])

Store a SIMD vector into a slice.

fn splat(simd: S, val: i8) -> Self

Create a SIMD vector with all elements set to the given value.

fn block_splat(block: Self::Block) -> Self

Create a SIMD vector from a 128-bit vector of the same scalar type, repeated.

fn from_fn(simd: S, f: impl FnMut(usize) -> i8) -> Self

Create a SIMD vector where each element is produced by calling f with that element’s lane index (from 0 to SimdBase::LEN - 1).

fn slide<const SHIFT: usize>(self, rhs: impl SimdInto<Self, S>) -> Self

Concatenate [self, rhs] and extract Self::LEN elements starting at index SHIFT.

fn slide_within_blocks<const SHIFT: usize>( self, rhs: impl SimdInto<Self, S>, ) -> Self

Like slide, but operates independently on each 128-bit block.

fn swizzle_dyn_within_blocks( self, indices: impl SimdInto<Self::Bytes, S>, ) -> Self

Dynamically swizzle this vector’s bytes independently within each 128-bit block.

fn swizzle_dyn(self, indices: impl SimdInto<Self::Bytes, S>) -> Self

Dynamically swizzle this vector’s bytes across the whole vector.

fn swizzle_dyn_precise(self, indices: impl SimdInto<Self::Bytes, S>) -> Self

Dynamically swizzle this vector’s bytes across the whole vector.

fn abs(self) -> Self

Compute the absolute value of each element.

fn reverse(self) -> Self

Reverse the order of the vector’s elements.

fn reduce_max(self) -> Self::Element

Return the maximum element in the vector. Integer vectors always return the exact maximum.

fn reduce_min(self) -> Self::Element

Return the minimum element in the vector. Integer vectors always return the exact minimum.

fn reduce_max_precise(self) -> Self::Element

Return the maximum element in the vector, ignoring quiet NaNs.

fn reduce_min_precise(self) -> Self::Element

Return the minimum element in the vector, ignoring quiet NaNs.

fn reduce_sum(self) -> Self::Element

Return the sum of all elements in the vector. Integer addition wraps.

fn reduce_product(self) -> Self::Element

Return the product of all elements in the vector. Integer multiplication wraps.

fn max(self, rhs: impl SimdInto<Self, S>) -> Self

Return the element-wise maximum of two vectors.

fn min(self, rhs: impl SimdInto<Self, S>) -> Self

Return the element-wise minimum of two vectors.

fn max_precise(self, rhs: impl SimdInto<Self, S>) -> Self

Return the element-wise maximum of two vectors.

fn min_precise(self, rhs: impl SimdInto<Self, S>) -> Self

Return the element-wise minimum of two vectors.

fn simd_eq(self, rhs: impl SimdInto<Self, S>) -> Self::Mask

Compare two vectors element-wise for equality.

fn simd_lt(self, rhs: impl SimdInto<Self, S>) -> Self::Mask

Compare two vectors element-wise for less than.

fn simd_le(self, rhs: impl SimdInto<Self, S>) -> Self::Mask

Compare two vectors element-wise for less than or equal.

fn simd_ge(self, rhs: impl SimdInto<Self, S>) -> Self::Mask

Compare two vectors element-wise for greater than or equal.

fn simd_gt(self, rhs: impl SimdInto<Self, S>) -> Self::Mask

Compare two vectors element-wise for greater than.

fn zip_low(self, rhs: impl SimdInto<Self, S>) -> Self

Interleave the lower half elements of two vectors.

fn zip_high(self, rhs: impl SimdInto<Self, S>) -> Self

Interleave the upper half elements of two vectors.

fn unzip_low(self, rhs: impl SimdInto<Self, S>) -> Self

Extract even-indexed elements from two vectors.

fn unzip_high(self, rhs: impl SimdInto<Self, S>) -> Self

Extract odd-indexed elements from two vectors.

fn interleave(self, rhs: impl SimdInto<Self, S>) -> (Self, Self)

Interleave two vectors.

fn deinterleave(self, rhs: impl SimdInto<Self, S>) -> (Self, Self)

Deinterleave two vectors.

fn load_array(simd: S, val: Self::Array) -> Self

Create a SIMD vector from its corresponding lane array.

fn load_array_ref(simd: S, val: &Self::Array) -> Self

Create a SIMD vector from a reference to its corresponding lane array.

fn to_array(self) -> Self::Array

Convert this SIMD vector to its corresponding lane array.

fn as_array(&self) -> &Self::Array

Project this SIMD vector reference to its corresponding lane array reference.

fn as_mut_array(&mut self) -> &mut Self::Array

Project this mutable SIMD vector reference to its corresponding mutable lane array reference.

fn store_array(self, dest: &mut Self::Array)

Store this SIMD vector into its corresponding lane array.

fn rotate_elements_left<const OFFSET: usize>(self) -> Self

Rotate the vector elements to the left by OFFSET.

fn rotate_elements_right<const OFFSET: usize>(self) -> Self

Rotate the vector elements to the right by OFFSET.

fn shift_elements_left<const OFFSET: usize>( self, padding: Self::Element, ) -> Self

Shift the vector elements to the left by OFFSET, filling in with padding from the right.

fn shift_elements_right<const OFFSET: usize>( self, padding: Self::Element, ) -> Self

Shift the vector elements to the right by OFFSET, filling in with padding from the left.

impl<S: Simd> SimdCombine<S> for i8x32<S>

type Combined = i8x64<S>

fn combine(self, rhs: impl SimdInto<Self, S>) -> Self::Combined

Concatenate two vectors into a new one that’s twice as long.

impl<S: Simd> SimdFrom<[i8; 32], S> for i8x32<S>

fn simd_from(simd: S, val: [i8; 32]) -> Self

impl<S: Simd> SimdFrom<__m256i, S> for i8x32<S>

Available on x86 or x86-64 only.

fn simd_from(simd: S, arch: __m256i) -> Self

impl<S: Simd> SimdFrom<i8, S> for i8x32<S>

fn simd_from(simd: S, value: i8) -> Self

impl<S: Simd> SimdInt<S> for i8x32<S>

fn count_ones(self) -> Self

Return the number of ones in the binary representation of each element.

fn count_zeros(self) -> Self

Return the number of zeros in the binary representation of each element.

fn saturating_add(self, rhs: impl SimdInto<Self, S>) -> Self

Add two vectors element-wise, saturating on overflow.

fn saturating_sub(self, rhs: impl SimdInto<Self, S>) -> Self

Subtract two vectors element-wise, saturating on overflow.

fn to_float<T: SimdCvtFloat<Self>>(self) -> T

Convert this integer type to a floating-point type. This is a convenience method that delegates to SimdCvtFloat::float_from, and can only be called if there actually exists a target type of the same bit width (f32 or f64).

impl<S: Simd> SimdSplit<S> for i8x32<S>

type Split = i8x16<S>

fn split(self) -> (Self::Split, Self::Split)

Split this vector into left and right halves.

impl<S: Simd> SimdWiden<S> for i8x32<S>

type Widened = i16x16<S>

The same-width vector type with lanes twice as wide.

fn widen(self) -> (Self::Widened, Self::Widened)

Widen every lane, returning the lower and upper halves in that order.

impl<S: Simd> Sub for i8x32<S>

fn sub(self, rhs: Self) -> Self::Output

Subtract two vectors element-wise, wrapping on overflow.

type Output = i8x32<S>

The resulting type after applying the - operator.

impl<S: Simd> Sub<i8> for i8x32<S>

type Output = i8x32<S>

The resulting type after applying the - operator.

fn sub(self, rhs: i8) -> Self::Output

Performs the - operation.

impl<S: Simd> Sub<i8x32<S>> for i8

type Output = i8x32<S>

The resulting type after applying the - operator.

fn sub(self, rhs: i8x32<S>) -> Self::Output

Performs the - operation.

impl<S: Simd> SubAssign for i8x32<S>

fn sub_assign(&mut self, rhs: Self)

Subtract two vectors element-wise, wrapping on overflow.

impl<S: Simd> SubAssign<i8> for i8x32<S>

fn sub_assign(&mut self, rhs: i8)

Performs the -= operation.