Struct __m128i

#[repr(simd)]
pub struct __m128i(pub(in ::core_arch::x86) [i64; 2]);

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:

(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(any(target_arch = "x86", target_arch = "x86_64"))] {
#[cfg(target_arch = "x86")]
use std::arch::x86::*;
#[cfg(target_arch = "x86_64")]
use std::arch::x86_64::*;

# #[target_feature(enable = "sse2")]
# #[allow(unused_unsafe)] // temporary, to unstick CI
# unsafe fn foo() { unsafe {
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);
# }}
# if is_x86_feature_detected!("sse2") { unsafe { foo() } }
# }

Fields

0: [i64; 2]

Implementations

impl __m128i

const fn as_u8x16(self) -> Simd<u8, 16>
const fn as_u16x8(self) -> Simd<u16, 8>
const fn as_u32x4(self) -> Simd<u32, 4>
const fn as_u64x2(self) -> Simd<u64, 2>
const fn as_i8x16(self) -> Simd<i8, 16>
const fn as_i16x8(self) -> Simd<i16, 8>
const fn as_i32x4(self) -> Simd<i32, 4>
const fn as_i64x2(self) -> Simd<i64, 2>

impl __m128i

fn splat(value: i64) -> __m128i

Put the same value in every lane.

const fn as_array(&self) -> &[i64; 2]

Returns an array reference containing the entire SIMD vector.

fn as_mut_array(&mut self) -> &mut [i64; 2]

Returns a mutable array reference containing the entire SIMD vector.

Trait Implementations

impl Clone for __m128i

fn clone(&self) -> __m128i

impl Copy for __m128i

impl Debug for __m128i

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

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

fn from(value: i16x8) -> __m128i

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

fn from(value: i32x4) -> __m128i

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

fn from(simd: Simd<i64, 2>) -> Self

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

fn from(value: i64x2) -> __m128i

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

fn from(value: i8x16) -> __m128i

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

fn from(value: u16x8) -> __m128i

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

fn from(value: u32x4) -> __m128i

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

fn from(value: u64x2) -> __m128i

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

fn from(value: u8x16) -> __m128i

impl TrivialClone for __m128i

Auto Trait Implementations

impl Freeze for __m128i

impl RefUnwindSafe for __m128i

impl Send for __m128i

impl Sync for __m128i

impl Unpin for __m128i

impl UnsafeUnpin for __m128i

impl UnwindSafe for __m128i

Blanket Implementations

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

fn type_id(&self) -> TypeId

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

fn borrow(&self) -> &T

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

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

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

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

impl<T> From<T> for __m128i

fn from(t: T) -> T

Returns the argument unchanged.

impl<T> Printable for __m128i where T: Copy + Debug,

impl<T> SizeHint for __m128i where T: ?Sized,

fn lower_bound(&self) -> usize
fn upper_bound(&self) -> Option<usize>

impl<T> SizedTypeProperties for __m128i

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

fn into(self) -> U

Calls U::from(self).

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

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

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

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

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