Struct X64V3Token 

pub struct X64V3Token { /* private fields */ }

Proof that AVX2 + FMA + BMI1/2 + F16C + LZCNT are available (x86-64-v3 level).

x86-64-v3 implies all of v2 plus: AVX, AVX2, FMA, BMI1, BMI2, F16C, LZCNT, MOVBE. This is the Haswell (2013) / Zen 1 (2017) baseline.

This is the most commonly targeted level for high-performance SIMD code.

Implementations

impl X64V3Token

pub fn v2(self) -> X64V2Token

Get a X64V2Token (x86-64-v3 implies x86-64-v2)

pub fn v1(self) -> X64V1Token

Get a X64V1Token (x86-64-v3 implies x86-64-v1)

impl X64V3Token

pub fn dangerously_disable_token_process_wide( disabled: bool, ) -> Result<(), CompileTimeGuaranteedError>

Disable this token process-wide for testing and benchmarking.

When disabled, summon() will return None even if the CPU supports the required features.

Returns Err when all required features are compile-time enabled (e.g., via -Ctarget-cpu=native), since the compiler has already elided the runtime checks.

Cascading: Also affects descendants:

• X64V4Token
• Avx512ModernToken
• Avx512Fp16Token

pub fn manually_disabled() -> Result<bool, CompileTimeGuaranteedError>

Check if this token has been manually disabled process-wide.

Returns Err when all required features are compile-time enabled.

Trait Implementations

impl Clone for X64V3Token

fn clone(&self) -> X64V3Token

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for X64V3Token

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

Formats the value using the given formatter.

impl IntoConcreteToken for X64V3Token

fn as_x64v3(self) -> Option<X64V3Token>

Try to cast to X64V3Token.

fn as_x64v1(self) -> Option<X64V1Token>

Try to cast to X64V1Token.

fn as_x64v2(self) -> Option<X64V2Token>

Try to cast to X64V2Token.

fn as_x64v4(self) -> Option<X64V4Token>

Try to cast to X64V4Token.

fn as_avx512_modern(self) -> Option<Avx512ModernToken>

Try to cast to Avx512ModernToken.

fn as_avx512_fp16(self) -> Option<Avx512Fp16Token>

Try to cast to Avx512Fp16Token.

fn as_neon(self) -> Option<NeonToken>

Try to cast to NeonToken.

fn as_neon_aes(self) -> Option<NeonAesToken>

Try to cast to NeonAesToken.

fn as_neon_sha3(self) -> Option<NeonSha3Token>

Try to cast to NeonSha3Token.

fn as_neon_crc(self) -> Option<NeonCrcToken>

Try to cast to NeonCrcToken.

fn as_wasm128(self) -> Option<Wasm128Token>

Try to cast to Wasm128Token.

fn as_scalar(self) -> Option<ScalarToken>

Try to cast to ScalarToken.

impl SimdToken for X64V3Token

const NAME: &'static str = "x86-64-v3"

Human-readable name for diagnostics and error messages.

const TARGET_FEATURES: &'static str = "sse,sse2,sse3,ssse3,sse4.1,sse4.2,popcnt,avx,avx2,fma,bmi1,bmi2,f16c,lzcnt"

Comma-delimited target features (e.g., "sse,sse2,avx2,fma,bmi1,bmi2,f16c,lzcnt").

const ENABLE_TARGET_FEATURES: &'static str = "-Ctarget-feature=+sse,+sse2,+sse3,+ssse3,+sse4.1,+sse4.2,+popcnt,+avx,+avx2,+fma,+bmi1,+bmi2,+f16c,+lzcnt"

RUSTFLAGS to enable these features at compile time.

const DISABLE_TARGET_FEATURES: &'static str = "-Ctarget-feature=-sse,-sse2,-sse3,-ssse3,-sse4.1,-sse4.2,-popcnt,-avx,-avx2,-fma,-bmi1,-bmi2,-f16c,-lzcnt"

RUSTFLAGS to disable these features at compile time.

fn compiled_with() -> Option<bool>

Check if this binary was compiled with the required target features enabled.

fn summon() -> Option<X64V3Token>

Attempt to create a token with runtime feature detection.

unsafe fn forge_token_dangerously() -> X64V3Token

👎Deprecated since 0.5.0: Pass tokens through from summon() instead of forging

Create a token without any checks.

fn guaranteed() -> Option<bool>

👎Deprecated since 0.6.0: Use compiled_with() instead

Deprecated alias for compiled_with().

fn attempt() -> Option<Self>

Attempt to create a token with runtime feature detection.

impl SimdTypes for X64V3Token

Available on x86-64 only.

const F32_LANES: usize = 8

Number of f32 lanes in the F32 type

const F64_LANES: usize = 4

Number of f64 lanes in the F64 type

const I32_LANES: usize = 8

Number of i32 lanes in the I32 type

type F32 = f32x8

32-bit floating point vector (e.g., f32x8 for AVX2)

type F64 = f64x4

64-bit floating point vector (e.g., f64x4 for AVX2)

type I8 = i8x32

8-bit signed integer vector

type I16 = i16x16

16-bit signed integer vector

type I32 = i32x8

32-bit signed integer vector

type I64 = i64x4

64-bit signed integer vector

type U8 = u8x32

8-bit unsigned integer vector

type U16 = u16x16

16-bit unsigned integer vector

type U32 = u32x8

32-bit unsigned integer vector

type U64 = u64x4

64-bit unsigned integer vector

impl WidthDispatch for X64V3Token

type F32x4 = f32x4

type F64x2 = f64x2

type I8x16 = i8x16

type U8x16 = u8x16

type I16x8 = i16x8

type U16x8 = u16x8

type I32x4 = i32x4

type U32x4 = u32x4

type I64x2 = i64x2

type U64x2 = u64x2

type F32x8 = f32x8

type F64x4 = f64x4

type I8x32 = i8x32

type U8x32 = u8x32

type I16x16 = i16x16

type U16x16 = u16x16

type I32x8 = i32x8

type U32x8 = u32x8

type I64x4 = i64x4

type U64x4 = u64x4

type F32x16 = f32x16

type F64x8 = f64x8

type I8x64 = i8x64

type U8x64 = u8x64

type I16x32 = i16x32

type U16x32 = u16x32

type I32x16 = i32x16

type U32x16 = u32x16

type I64x8 = i64x8

type U64x8 = u64x8

fn f32x4_splat(self, v: f32) -> <X64V3Token as WidthDispatch>::F32x4

fn f32x4_zero(self) -> <X64V3Token as WidthDispatch>::F32x4

fn f32x4_load(self, data: &[f32; 4]) -> <X64V3Token as WidthDispatch>::F32x4

fn f64x2_splat(self, v: f64) -> <X64V3Token as WidthDispatch>::F64x2

fn f64x2_zero(self) -> <X64V3Token as WidthDispatch>::F64x2

fn f64x2_load(self, data: &[f64; 2]) -> <X64V3Token as WidthDispatch>::F64x2

fn i8x16_splat(self, v: i8) -> <X64V3Token as WidthDispatch>::I8x16

fn i8x16_zero(self) -> <X64V3Token as WidthDispatch>::I8x16

fn i8x16_load(self, data: &[i8; 16]) -> <X64V3Token as WidthDispatch>::I8x16

fn u8x16_splat(self, v: u8) -> <X64V3Token as WidthDispatch>::U8x16

fn u8x16_zero(self) -> <X64V3Token as WidthDispatch>::U8x16

fn u8x16_load(self, data: &[u8; 16]) -> <X64V3Token as WidthDispatch>::U8x16

fn i16x8_splat(self, v: i16) -> <X64V3Token as WidthDispatch>::I16x8

fn i16x8_zero(self) -> <X64V3Token as WidthDispatch>::I16x8

fn i16x8_load(self, data: &[i16; 8]) -> <X64V3Token as WidthDispatch>::I16x8

fn u16x8_splat(self, v: u16) -> <X64V3Token as WidthDispatch>::U16x8

fn u16x8_zero(self) -> <X64V3Token as WidthDispatch>::U16x8

fn u16x8_load(self, data: &[u16; 8]) -> <X64V3Token as WidthDispatch>::U16x8

fn i32x4_splat(self, v: i32) -> <X64V3Token as WidthDispatch>::I32x4

fn i32x4_zero(self) -> <X64V3Token as WidthDispatch>::I32x4

fn i32x4_load(self, data: &[i32; 4]) -> <X64V3Token as WidthDispatch>::I32x4

fn u32x4_splat(self, v: u32) -> <X64V3Token as WidthDispatch>::U32x4

fn u32x4_zero(self) -> <X64V3Token as WidthDispatch>::U32x4

fn u32x4_load(self, data: &[u32; 4]) -> <X64V3Token as WidthDispatch>::U32x4

fn i64x2_splat(self, v: i64) -> <X64V3Token as WidthDispatch>::I64x2

fn i64x2_zero(self) -> <X64V3Token as WidthDispatch>::I64x2

fn i64x2_load(self, data: &[i64; 2]) -> <X64V3Token as WidthDispatch>::I64x2

fn u64x2_splat(self, v: u64) -> <X64V3Token as WidthDispatch>::U64x2

fn u64x2_zero(self) -> <X64V3Token as WidthDispatch>::U64x2

fn u64x2_load(self, data: &[u64; 2]) -> <X64V3Token as WidthDispatch>::U64x2

fn f32x8_splat(self, v: f32) -> <X64V3Token as WidthDispatch>::F32x8

fn f32x8_zero(self) -> <X64V3Token as WidthDispatch>::F32x8

fn f32x8_load(self, data: &[f32; 8]) -> <X64V3Token as WidthDispatch>::F32x8

fn f64x4_splat(self, v: f64) -> <X64V3Token as WidthDispatch>::F64x4

fn f64x4_zero(self) -> <X64V3Token as WidthDispatch>::F64x4

fn f64x4_load(self, data: &[f64; 4]) -> <X64V3Token as WidthDispatch>::F64x4

fn i8x32_splat(self, v: i8) -> <X64V3Token as WidthDispatch>::I8x32

fn i8x32_zero(self) -> <X64V3Token as WidthDispatch>::I8x32

fn i8x32_load(self, data: &[i8; 32]) -> <X64V3Token as WidthDispatch>::I8x32

fn u8x32_splat(self, v: u8) -> <X64V3Token as WidthDispatch>::U8x32

fn u8x32_zero(self) -> <X64V3Token as WidthDispatch>::U8x32

fn u8x32_load(self, data: &[u8; 32]) -> <X64V3Token as WidthDispatch>::U8x32

fn i16x16_splat(self, v: i16) -> <X64V3Token as WidthDispatch>::I16x16

fn i16x16_zero(self) -> <X64V3Token as WidthDispatch>::I16x16

fn i16x16_load(self, data: &[i16; 16]) -> <X64V3Token as WidthDispatch>::I16x16

fn u16x16_splat(self, v: u16) -> <X64V3Token as WidthDispatch>::U16x16

fn u16x16_zero(self) -> <X64V3Token as WidthDispatch>::U16x16

fn u16x16_load(self, data: &[u16; 16]) -> <X64V3Token as WidthDispatch>::U16x16

fn i32x8_splat(self, v: i32) -> <X64V3Token as WidthDispatch>::I32x8

fn i32x8_zero(self) -> <X64V3Token as WidthDispatch>::I32x8

fn i32x8_load(self, data: &[i32; 8]) -> <X64V3Token as WidthDispatch>::I32x8

fn u32x8_splat(self, v: u32) -> <X64V3Token as WidthDispatch>::U32x8

fn u32x8_zero(self) -> <X64V3Token as WidthDispatch>::U32x8

fn u32x8_load(self, data: &[u32; 8]) -> <X64V3Token as WidthDispatch>::U32x8

fn i64x4_splat(self, v: i64) -> <X64V3Token as WidthDispatch>::I64x4

fn i64x4_zero(self) -> <X64V3Token as WidthDispatch>::I64x4

fn i64x4_load(self, data: &[i64; 4]) -> <X64V3Token as WidthDispatch>::I64x4

fn u64x4_splat(self, v: u64) -> <X64V3Token as WidthDispatch>::U64x4

fn u64x4_zero(self) -> <X64V3Token as WidthDispatch>::U64x4

fn u64x4_load(self, data: &[u64; 4]) -> <X64V3Token as WidthDispatch>::U64x4

fn f32x16_splat(self, v: f32) -> <X64V3Token as WidthDispatch>::F32x16

fn f32x16_zero(self) -> <X64V3Token as WidthDispatch>::F32x16

fn f32x16_load(self, data: &[f32; 16]) -> <X64V3Token as WidthDispatch>::F32x16

fn f64x8_splat(self, v: f64) -> <X64V3Token as WidthDispatch>::F64x8

fn f64x8_zero(self) -> <X64V3Token as WidthDispatch>::F64x8

fn f64x8_load(self, data: &[f64; 8]) -> <X64V3Token as WidthDispatch>::F64x8

fn i8x64_splat(self, v: i8) -> <X64V3Token as WidthDispatch>::I8x64

fn i8x64_zero(self) -> <X64V3Token as WidthDispatch>::I8x64

fn i8x64_load(self, data: &[i8; 64]) -> <X64V3Token as WidthDispatch>::I8x64

fn u8x64_splat(self, v: u8) -> <X64V3Token as WidthDispatch>::U8x64

fn u8x64_zero(self) -> <X64V3Token as WidthDispatch>::U8x64

fn u8x64_load(self, data: &[u8; 64]) -> <X64V3Token as WidthDispatch>::U8x64

fn i16x32_splat(self, v: i16) -> <X64V3Token as WidthDispatch>::I16x32

fn i16x32_zero(self) -> <X64V3Token as WidthDispatch>::I16x32

fn i16x32_load(self, data: &[i16; 32]) -> <X64V3Token as WidthDispatch>::I16x32

fn u16x32_splat(self, v: u16) -> <X64V3Token as WidthDispatch>::U16x32

fn u16x32_zero(self) -> <X64V3Token as WidthDispatch>::U16x32

fn u16x32_load(self, data: &[u16; 32]) -> <X64V3Token as WidthDispatch>::U16x32

fn i32x16_splat(self, v: i32) -> <X64V3Token as WidthDispatch>::I32x16

fn i32x16_zero(self) -> <X64V3Token as WidthDispatch>::I32x16

fn i32x16_load(self, data: &[i32; 16]) -> <X64V3Token as WidthDispatch>::I32x16

fn u32x16_splat(self, v: u32) -> <X64V3Token as WidthDispatch>::U32x16

fn u32x16_zero(self) -> <X64V3Token as WidthDispatch>::U32x16

fn u32x16_load(self, data: &[u32; 16]) -> <X64V3Token as WidthDispatch>::U32x16

fn i64x8_splat(self, v: i64) -> <X64V3Token as WidthDispatch>::I64x8

fn i64x8_zero(self) -> <X64V3Token as WidthDispatch>::I64x8

fn i64x8_load(self, data: &[i64; 8]) -> <X64V3Token as WidthDispatch>::I64x8

fn u64x8_splat(self, v: u64) -> <X64V3Token as WidthDispatch>::U64x8

fn u64x8_zero(self) -> <X64V3Token as WidthDispatch>::U64x8

fn u64x8_load(self, data: &[u64; 8]) -> <X64V3Token as WidthDispatch>::U64x8

impl Copy for X64V3Token

impl Has128BitSimd for X64V3Token

impl Has256BitSimd for X64V3Token

impl HasX64V2 for X64V3Token

impl Sealed for X64V3Token