__m128i

Struct __m128i 

1.27.0 · Source
pub struct __m128i(/* private fields */);
Available on x86-64 only.
Expand description

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§

1.27.0 · Source§

impl Clone for __m128i

Available on x86 or x86-64 only.
Source§

fn clone(&self) -> __m128i

Returns a duplicate of the value. Read more
1.0.0 · Source§

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

Performs copy-assignment from source. Read more
1.27.0 · Source§

impl Debug for __m128i

Available on x86 or x86-64 only.
Source§

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

Formats the value using the given formatter. Read more
Source§

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

Available on x86 or x86-64 only.
Source§

fn from(value: i16x8) -> __m128i

Converts to this type from the input type.
Source§

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

Available on x86 or x86-64 only.
Source§

fn from(value: i32x4) -> __m128i

Converts to this type from the input type.
Source§

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

Available on x86 or x86-64 only.
Source§

fn from(value: i64x2) -> __m128i

Converts to this type from the input type.
Source§

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

Available on x86 or x86-64 only.
Source§

fn from(value: i8x16) -> __m128i

Converts to this type from the input type.
Source§

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

Available on x86 or x86-64 only.
Source§

fn from(value: isizex2) -> __m128i

Converts to this type from the input type.
Source§

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

Available on x86 or x86-64 only.
Source§

fn from(value: u16x8) -> __m128i

Converts to this type from the input type.
Source§

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

Available on x86 or x86-64 only.
Source§

fn from(value: u32x4) -> __m128i

Converts to this type from the input type.
Source§

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

Available on x86 or x86-64 only.
Source§

fn from(value: u64x2) -> __m128i

Converts to this type from the input type.
Source§

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

Available on x86 or x86-64 only.
Source§

fn from(value: u8x16) -> __m128i

Converts to this type from the input type.
Source§

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

Available on x86 or x86-64 only.
Source§

fn from(value: usizex2) -> __m128i

Converts to this type from the input type.
Source§

impl From<__m128i> for i16x8

Available on x86 or x86-64 only.
Source§

fn from(value: __m128i) -> i16x8

Converts to this type from the input type.
Source§

impl From<__m128i> for i32x4

Available on x86 or x86-64 only.
Source§

fn from(value: __m128i) -> i32x4

Converts to this type from the input type.
Source§

impl From<__m128i> for i64x2

Available on x86 or x86-64 only.
Source§

fn from(value: __m128i) -> i64x2

Converts to this type from the input type.
Source§

impl From<__m128i> for i8x16

Available on x86 or x86-64 only.
Source§

fn from(value: __m128i) -> i8x16

Converts to this type from the input type.
Source§

impl From<__m128i> for isizex2

Available on x86 or x86-64 only.
Source§

fn from(value: __m128i) -> isizex2

Converts to this type from the input type.
Source§

impl From<__m128i> for u16x8

Available on x86 or x86-64 only.
Source§

fn from(value: __m128i) -> u16x8

Converts to this type from the input type.
Source§

impl From<__m128i> for u32x4

Available on x86 or x86-64 only.
Source§

fn from(value: __m128i) -> u32x4

Converts to this type from the input type.
Source§

impl From<__m128i> for u64x2

Available on x86 or x86-64 only.
Source§

fn from(value: __m128i) -> u64x2

Converts to this type from the input type.
Source§

impl From<__m128i> for u8x16

Available on x86 or x86-64 only.
Source§

fn from(value: __m128i) -> u8x16

Converts to this type from the input type.
Source§

impl From<__m128i> for usizex2

Available on x86 or x86-64 only.
Source§

fn from(value: __m128i) -> usizex2

Converts to this type from the input type.
1.27.0 · Source§

impl Copy for __m128i

Available on x86 or x86-64 only.

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit #126799)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.