Struct __m256i

#[repr(simd)]
pub struct __m256i([i64; 4]);

Available on x86 or x86-64 only.

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:

• i8x32 - thirty two i8 variables packed together
• i16x16 - sixteen i16 variables packed together
• i32x8 - eight i32 variables packed together
• i64x4 - four 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 __m256i typically just means a “bag of bits” which is left up to interpretation at the point of use.

Examples

#[cfg(target_arch = "x86")]
use std::arch::x86::*;
#[cfg(target_arch = "x86_64")]
use std::arch::x86_64::*;

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);

Tuple Fields

0: [i64; 4]

Implementations

impl __m256i

fn splat(value: i64) -> __m256i

Using my_simd([x; N]) seemingly fails tests, so use this internal helper for it instead.

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

pub(crate) fn as_u8x32(self) -> u8x32

pub(crate) fn as_u16x16(self) -> u16x16

pub(crate) fn as_u32x8(self) -> u32x8

pub(crate) fn as_u64x4(self) -> u64x4

pub(crate) fn as_i8x32(self) -> i8x32

pub(crate) fn as_i16x16(self) -> i16x16

pub(crate) fn as_i32x8(self) -> i32x8

pub(crate) fn as_i64x4(self) -> i64x4

Trait Implementations

impl Clone for __m256i

fn clone(&self) -> __m256i

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for __m256i

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

Formats the value using the given formatter.

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

fn from(value: i16x16) -> __m256i

Converts to this type from the input type.

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

fn from(value: i32x8) -> __m256i

Converts to this type from the input type.

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

fn from(value: i64x4) -> __m256i

Converts to this type from the input type.

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

fn from(value: i8x32) -> __m256i

Converts to this type from the input type.

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

fn from(value: isizex4) -> __m256i

Converts to this type from the input type.

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

fn from(value: u16x16) -> __m256i

Converts to this type from the input type.

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

fn from(value: u32x8) -> __m256i

Converts to this type from the input type.

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

fn from(value: u64x4) -> __m256i

Converts to this type from the input type.

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

fn from(value: u8x32) -> __m256i

Converts to this type from the input type.

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

fn from(value: usizex4) -> __m256i

Converts to this type from the input type.

impl From<__m256i> for i16x16

fn from(value: __m256i) -> i16x16

Converts to this type from the input type.

impl From<__m256i> for i32x8

fn from(value: __m256i) -> i32x8

Converts to this type from the input type.

impl From<__m256i> for i64x4

fn from(value: __m256i) -> i64x4

Converts to this type from the input type.

impl From<__m256i> for i8x32

fn from(value: __m256i) -> i8x32

Converts to this type from the input type.

impl From<__m256i> for isizex4

fn from(value: __m256i) -> isizex4

Converts to this type from the input type.

impl From<__m256i> for u16x16

fn from(value: __m256i) -> u16x16

Converts to this type from the input type.

impl From<__m256i> for u32x8

fn from(value: __m256i) -> u32x8

Converts to this type from the input type.

impl From<__m256i> for u64x4

fn from(value: __m256i) -> u64x4

Converts to this type from the input type.

impl From<__m256i> for u8x32

fn from(value: __m256i) -> u8x32

Converts to this type from the input type.

impl From<__m256i> for usizex4

fn from(value: __m256i) -> usizex4

Converts to this type from the input type.

impl Copy for __m256i