Struct __m256i

#[repr(simd)]
pub struct __m256i(pub(in ::core_arch::x86) [i64; 4]);

256-bit wide integer vector type, x86-specific

This type is the same as the __m256i type defined by Intel, representing a 256-bit SIMD register. Usage of this type typically corresponds to the avx 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 __m256i typically just means a "bag of bits" which is left up to interpretation at the point of use.

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 all_bytes_zero = _mm256_setzero_si256();
let all_bytes_one = _mm256_set1_epi8(1);
let eight_i32 = _mm256_set_epi32(1, 2, 3, 4, 5, 6, 7, 8);
# }}
# if is_x86_feature_detected!("avx") { unsafe { foo() } }
# }

Fields

0: [i64; 4]

Implementations

impl __m256i

fn splat(value: i64) -> __m256i

Put the same value in every lane.

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

Returns an array reference containing the entire SIMD vector.

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

Returns a mutable array reference containing the entire SIMD vector.

impl __m256i

const fn as_u8x32(self) -> Simd<u8, 32>
const fn as_u16x16(self) -> Simd<u16, 16>
const fn as_u32x8(self) -> Simd<u32, 8>
const fn as_u64x4(self) -> Simd<u64, 4>
const fn as_i8x32(self) -> Simd<i8, 32>
const fn as_i16x16(self) -> Simd<i16, 16>
const fn as_i32x8(self) -> Simd<i32, 8>
const fn as_i64x4(self) -> Simd<i64, 4>

Trait Implementations

impl Clone for __m256i

fn clone(&self) -> __m256i

impl Copy for __m256i

impl Debug for __m256i

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

impl From<Simd<i16, 16>> for __m256i

fn from(value: i16x16) -> __m256i

impl From<Simd<i32, 8>> for __m256i

fn from(value: i32x8) -> __m256i

impl From<Simd<i64, 4>> for __m256i

fn from(value: i64x4) -> __m256i

impl From<Simd<i64, 4>> for __m256i

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

impl From<Simd<i8, 32>> for __m256i

fn from(value: i8x32) -> __m256i

impl From<Simd<u16, 16>> for __m256i

fn from(value: u16x16) -> __m256i

impl From<Simd<u32, 8>> for __m256i

fn from(value: u32x8) -> __m256i

impl From<Simd<u64, 4>> for __m256i

fn from(value: u64x4) -> __m256i

impl From<Simd<u8, 32>> for __m256i

fn from(value: u8x32) -> __m256i

impl TrivialClone for __m256i

Auto Trait Implementations

impl Freeze for __m256i

impl RefUnwindSafe for __m256i

impl Send for __m256i

impl Sync for __m256i

impl Unpin for __m256i

impl UnsafeUnpin for __m256i

impl UnwindSafe for __m256i

Blanket Implementations

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

fn type_id(&self) -> TypeId

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

fn borrow(&self) -> &T

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

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

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

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

impl<T> From<T> for __m256i

fn from(t: T) -> T

Returns the argument unchanged.

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

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

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

impl<T> SizedTypeProperties for __m256i

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

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