Struct __m256

#[repr(simd)]
pub struct __m256(pub(in ::core_arch::x86) [f32; 8]);

256-bit wide set of eight f32 types, x86-specific

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

Note that unlike __m256i, the integer version of the 256-bit registers, this __m256 type has one interpretation. Each instance of __m256 always corresponds to f32x8, or eight 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 between two consecutive elements); 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 __m256 are prefixed with _mm256_ and are suffixed with "ps" (or otherwise contain "ps"). Not to be confused with "pd" which is used for __m256d.

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 = "avx")]
# #[allow(unused_unsafe)] // temporary, to unstick CI
# unsafe fn foo() { unsafe {
let eight_zeros = _mm256_setzero_ps();
let eight_ones = _mm256_set1_ps(1.0);
let eight_floats = _mm256_set_ps(1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0);
# }}
# if is_x86_feature_detected!("avx") { unsafe { foo() } }
# }

Fields

0: [f32; 8]

Implementations

impl __m256

const fn as_f32x8(self) -> Simd<f32, 8>

impl __m256

fn splat(value: f32) -> __m256

Put the same value in every lane.

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

Returns an array reference containing the entire SIMD vector.

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

Returns a mutable array reference containing the entire SIMD vector.

Trait Implementations

impl Clone for __m256

fn clone(&self) -> __m256

impl Copy for __m256

impl Debug for __m256

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

impl From<Simd<f32, 8>> for __m256

fn from(value: f32x8) -> __m256

impl From<Simd<f32, 8>> for __m256

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

impl TrivialClone for __m256

Auto Trait Implementations

impl Freeze for __m256

impl RefUnwindSafe for __m256

impl Send for __m256

impl Sync for __m256

impl Unpin for __m256

impl UnsafeUnpin for __m256

impl UnwindSafe for __m256

Blanket Implementations

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

fn type_id(&self) -> TypeId

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

fn borrow(&self) -> &T

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

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

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

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

impl<T> From<T> for __m256

fn from(t: T) -> T

Returns the argument unchanged.

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

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

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

impl<T> SizedTypeProperties for __m256

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

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

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

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