Struct __m128

#[repr(simd)]
pub struct __m128(pub(in ::core_arch::x86) [f32; 4]);

128-bit wide set of four f32 types, x86-specific

This type is the same as the __m128 type defined by Intel, representing a 128-bit SIMD register which internally is consisted of four packed f32 instances. Usage of this type typically corresponds to the sse and up target features for x86/x86_64.

Note that unlike __m128i, the integer version of the 128-bit registers, this __m128 type has one interpretation. Each instance of __m128 always corresponds to f32x4, or four f32 types packed together.

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.

Most intrinsics using __m128 are prefixed with _mm_ and are suffixed with "ps" (or otherwise contain "ps"). Not to be confused with "pd" which is used for __m128d.

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 = "sse")]
# #[allow(unused_unsafe)] // temporary, to unstick CI
# unsafe fn foo() { unsafe {
let four_zeros = _mm_setzero_ps();
let four_ones = _mm_set1_ps(1.0);
let four_floats = _mm_set_ps(1.0, 2.0, 3.0, 4.0);
# }}
# if is_x86_feature_detected!("sse") { unsafe { foo() } }
# }

Fields

0: [f32; 4]

Implementations

impl __m128

fn splat(value: f32) -> __m128

Put the same value in every lane.

const fn as_array(&self) -> &[f32; 4]

Returns an array reference containing the entire SIMD vector.

fn as_mut_array(&mut self) -> &mut [f32; 4]

Returns a mutable array reference containing the entire SIMD vector.

impl __m128

const fn as_f32x4(self) -> Simd<f32, 4>

Trait Implementations

impl Clone for __m128

fn clone(&self) -> __m128

impl Copy for __m128

impl Debug for __m128

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

impl From<Simd<f32, 4>> for __m128

fn from(value: f32x4) -> __m128

impl From<Simd<f32, 4>> for __m128

fn from(simd: Simd<f32, 4>) -> Self

impl TrivialClone for __m128

Auto Trait Implementations

impl Freeze for __m128

impl RefUnwindSafe for __m128

impl Send for __m128

impl Sync for __m128

impl Unpin for __m128

impl UnsafeUnpin for __m128

impl UnwindSafe for __m128

Blanket Implementations

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

fn type_id(&self) -> TypeId

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

fn borrow(&self) -> &T

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

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

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

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

impl<T> From<T> for __m128

fn from(t: T) -> T

Returns the argument unchanged.

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

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

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

impl<T> SizedTypeProperties for __m128

impl<T, U> Into<U> for __m128 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 __m128 where U: Into<T>,

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

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

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