Struct __m128i

#[repr(simd)]
pub struct __m128i(/* private fields */);

Available on x86-64 only.

128-bit wide integer vector type, x86-specific

This type is the same as the __m128i type defined by Intel, representing a 128-bit SIMD register. Usage of this type typically corresponds to the sse and up target features for x86/x86_64.

Internally this type may be viewed as:

• i8x16 - sixteen i8 variables packed together
• i16x8 - eight i16 variables packed together
• i32x4 - four i32 variables packed together
• i64x2 - two i64 variables packed together

(as well as unsigned versions). Each intrinsic may interpret the internal bits differently, check the documentation of the intrinsic to see how it’s being used.

The in-memory representation of this type is the same as the one of an equivalent array (i.e. the in-memory order of elements is the same, and there is no padding); however, the alignment is different and equal to the size of the type. Note that the ABI for function calls may not be the same.

Note that this means that an instance of __m128i typically just means a “bag of bits” which is left up to interpretation at the point of use.

Most intrinsics using __m128i are prefixed with _mm_ and the integer types tend to correspond to suffixes like “epi8” or “epi32”.

Examples

#[cfg(target_arch = "x86")]
use std::arch::x86::*;
#[cfg(target_arch = "x86_64")]
use std::arch::x86_64::*;

let all_bytes_zero = _mm_setzero_si128();
let all_bytes_one = _mm_set1_epi8(1);
let four_i32 = _mm_set_epi32(1, 2, 3, 4);

Trait Implementations

impl Clone for __m128i

fn clone(&self) -> __m128i

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for __m128i

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

Formats the value using the given formatter.

impl From<Simd<i16, 8>> for __m128i

fn from(value: Simd<i16, 8>) -> __m128i

Converts to this type from the input type.

impl From<Simd<i32, 4>> for __m128i

fn from(value: Simd<i32, 4>) -> __m128i

Converts to this type from the input type.

impl From<Simd<i64, 2>> for __m128i

fn from(value: Simd<i64, 2>) -> __m128i

Converts to this type from the input type.

impl From<Simd<i8, 16>> for __m128i

fn from(value: Simd<i8, 16>) -> __m128i

Converts to this type from the input type.

impl From<Simd<isize, 2>> for __m128i

fn from(value: Simd<isize, 2>) -> __m128i

Converts to this type from the input type.

impl From<Simd<u16, 8>> for __m128i

fn from(value: Simd<u16, 8>) -> __m128i

Converts to this type from the input type.

impl From<Simd<u32, 4>> for __m128i

fn from(value: Simd<u32, 4>) -> __m128i

Converts to this type from the input type.

impl From<Simd<u64, 2>> for __m128i

fn from(value: Simd<u64, 2>) -> __m128i

Converts to this type from the input type.

impl From<Simd<u8, 16>> for __m128i

fn from(value: Simd<u8, 16>) -> __m128i

Converts to this type from the input type.

impl From<Simd<usize, 2>> for __m128i

fn from(value: Simd<usize, 2>) -> __m128i

Converts to this type from the input type.

impl From<__m128i> for Simd<i16, 8>

fn from(value: __m128i) -> Simd<i16, 8>

Converts to this type from the input type.

impl From<__m128i> for Simd<i32, 4>

fn from(value: __m128i) -> Simd<i32, 4>

Converts to this type from the input type.

impl From<__m128i> for Simd<i64, 2>

fn from(value: __m128i) -> Simd<i64, 2>

Converts to this type from the input type.

impl From<__m128i> for Simd<i8, 16>

fn from(value: __m128i) -> Simd<i8, 16>

Converts to this type from the input type.

impl From<__m128i> for Simd<isize, 2>

fn from(value: __m128i) -> Simd<isize, 2>

Converts to this type from the input type.

impl From<__m128i> for Simd<u16, 8>

fn from(value: __m128i) -> Simd<u16, 8>

Converts to this type from the input type.

impl From<__m128i> for Simd<u32, 4>

fn from(value: __m128i) -> Simd<u32, 4>

Converts to this type from the input type.

impl From<__m128i> for Simd<u64, 2>

fn from(value: __m128i) -> Simd<u64, 2>

Converts to this type from the input type.

impl From<__m128i> for Simd<u8, 16>

fn from(value: __m128i) -> Simd<u8, 16>

Converts to this type from the input type.

impl From<__m128i> for Simd<usize, 2>

fn from(value: __m128i) -> Simd<usize, 2>

Converts to this type from the input type.

impl TransparentWrapper<__m128i> for m128i

fn wrap(s: Inner) -> Self

where Self: Sized,

Convert the inner type into the wrapper type.

fn wrap_ref(s: &Inner) -> &Self

Convert a reference to the inner type into a reference to the wrapper type.

fn wrap_mut(s: &mut Inner) -> &mut Self

Convert a mutable reference to the inner type into a mutable reference to the wrapper type.

fn wrap_slice(s: &[Inner]) -> &[Self]

where Self: Sized,

Convert a slice to the inner type into a slice to the wrapper type.

fn wrap_slice_mut(s: &mut [Inner]) -> &mut [Self]

where Self: Sized,

Convert a mutable slice to the inner type into a mutable slice to the wrapper type.

fn peel(s: Self) -> Inner

where Self: Sized,

Convert the wrapper type into the inner type.

fn peel_ref(s: &Self) -> &Inner

Convert a reference to the wrapper type into a reference to the inner type.

fn peel_mut(s: &mut Self) -> &mut Inner

Convert a mutable reference to the wrapper type into a mutable reference to the inner type.

fn peel_slice(s: &[Self]) -> &[Inner]

where Self: Sized,

Convert a slice to the wrapped type into a slice to the inner type.

fn peel_slice_mut(s: &mut [Self]) -> &mut [Inner]

where Self: Sized,

Convert a mutable slice to the wrapped type into a mutable slice to the inner type.

impl TransparentWrapper<__m128i> for m128i

fn wrap(s: Inner) -> Self

where Self: Sized,

Convert the inner type into the wrapper type.

fn wrap_ref(s: &Inner) -> &Self

Convert a reference to the inner type into a reference to the wrapper type.

fn wrap_mut(s: &mut Inner) -> &mut Self

Convert a mutable reference to the inner type into a mutable reference to the wrapper type.

fn wrap_slice(s: &[Inner]) -> &[Self]

where Self: Sized,

Convert a slice to the inner type into a slice to the wrapper type.

fn wrap_slice_mut(s: &mut [Inner]) -> &mut [Self]

where Self: Sized,

Convert a mutable slice to the inner type into a mutable slice to the wrapper type.

fn peel(s: Self) -> Inner

where Self: Sized,

Convert the wrapper type into the inner type.

fn peel_ref(s: &Self) -> &Inner

Convert a reference to the wrapper type into a reference to the inner type.

fn peel_mut(s: &mut Self) -> &mut Inner

Convert a mutable reference to the wrapper type into a mutable reference to the inner type.

fn peel_slice(s: &[Self]) -> &[Inner]

where Self: Sized,

Convert a slice to the wrapped type into a slice to the inner type.

fn peel_slice_mut(s: &mut [Self]) -> &mut [Inner]

where Self: Sized,

Convert a mutable slice to the wrapped type into a mutable slice to the inner type.

impl Zeroable for __m128i

fn zeroed() -> Self

Calls zeroed.

impl Zeroize for __m128i

fn zeroize(&mut self)

Zero out this object from memory using Rust intrinsics which ensure the zeroization operation is not “optimized away” by the compiler.

impl Copy for __m128i

impl Pod for __m128i