Struct core::simd::Mask

#[repr(transparent)]
pub struct Mask<T, const LANES: usize>(_)
 where
    T: MaskElement,
    LaneCount<LANES>: SupportedLaneCount;

🔬 This is a nightly-only experimental API. (portable_simd #86656)

A SIMD vector mask for LANES elements of width specified by Element.

The layout of this type is unspecified.

Implementations

impl<T, const LANES: usize> Mask<T, LANES> where
    T: MaskElement,
    LaneCount<LANES>: SupportedLaneCount, 

pub fn splat(value: bool) -> Self

🔬 This is a nightly-only experimental API. (portable_simd #86656)

Construct a mask by setting all lanes to the given value.

pub fn from_array(array: [bool; LANES]) -> Self

🔬 This is a nightly-only experimental API. (portable_simd #86656)

Converts an array to a SIMD vector.

pub fn to_array(self) -> [bool; LANES]

🔬 This is a nightly-only experimental API. (portable_simd #86656)

Converts a SIMD vector to an array.

pub unsafe fn from_int_unchecked(value: Simd<T, LANES>) -> Self

🔬 This is a nightly-only experimental API. (portable_simd #86656)

Converts a vector of integers to a mask, where 0 represents false and -1 represents true.

Safety

All lanes must be either 0 or -1.

pub fn from_int(value: Simd<T, LANES>) -> Self

🔬 This is a nightly-only experimental API. (portable_simd #86656)

Converts a vector of integers to a mask, where 0 represents false and -1 represents true.

Panics

Panics if any lane is not 0 or -1.

pub fn to_int(self) -> Simd<T, LANES>

🔬 This is a nightly-only experimental API. (portable_simd #86656)

Converts the mask to a vector of integers, where 0 represents false and -1 represents true.

pub unsafe fn test_unchecked(&self, lane: usize) -> bool

🔬 This is a nightly-only experimental API. (portable_simd #86656)

Tests the value of the specified lane.

Safety

lane must be less than LANES.

pub fn test(&self, lane: usize) -> bool

🔬 This is a nightly-only experimental API. (portable_simd #86656)

Tests the value of the specified lane.

Panics

Panics if lane is greater than or equal to the number of lanes in the vector.

pub unsafe fn set_unchecked(&mut self, lane: usize, value: bool)

🔬 This is a nightly-only experimental API. (portable_simd #86656)

Sets the value of the specified lane.

Safety

lane must be less than LANES.

pub fn set(&mut self, lane: usize, value: bool)

🔬 This is a nightly-only experimental API. (portable_simd #86656)

Sets the value of the specified lane.

Panics

Panics if lane is greater than or equal to the number of lanes in the vector.

pub fn any(self) -> bool

🔬 This is a nightly-only experimental API. (portable_simd #86656)

Returns true if any lane is set, or false otherwise.

pub fn all(self) -> bool

🔬 This is a nightly-only experimental API. (portable_simd #86656)

Returns true if all lanes are set, or false otherwise.

impl<T, const LANES: usize> Mask<T, LANES> where
    T: MaskElement,
    LaneCount<LANES>: SupportedLaneCount, 

pub fn select<S: Select<Self>>(self, true_values: S, false_values: S) -> S

🔬 This is a nightly-only experimental API. (portable_simd #86656)

Choose lanes from two vectors.

For each lane in the mask, choose the corresponding lane from true_values if that lane mask is true, and false_values if that lane mask is false.

let a = Simd::from_array([0, 1, 2, 3]);
let b = Simd::from_array([4, 5, 6, 7]);
let mask = Mask::from_array([true, false, false, true]);
let c = mask.select(a, b);
assert_eq!(c.to_array(), [0, 5, 6, 3]);

select can also be used on masks:

let a = Mask::<i32, 4>::from_array([true, true, false, false]);
let b = Mask::<i32, 4>::from_array([false, false, true, true]);
let mask = Mask::<i32, 4>::from_array([true, false, false, true]);
let c = mask.select(a, b);
assert_eq!(c.to_array(), [true, false, true, false]);

Trait Implementations

impl<T, const LANES: usize> BitAnd<Mask<T, LANES>> for Mask<T, LANES> where
    T: MaskElement,
    LaneCount<LANES>: SupportedLaneCount, 

type Output = Self

The resulting type after applying the & operator.

fn bitand(self, rhs: Self) -> Self

Performs the & operation.

impl<T, const LANES: usize> BitAnd<Mask<T, LANES>> for bool where
    T: MaskElement,
    LaneCount<LANES>: SupportedLaneCount, 

type Output = Mask<T, LANES>

The resulting type after applying the & operator.

fn bitand(self, rhs: Mask<T, LANES>) -> Mask<T, LANES>

Performs the & operation.

impl<T, const LANES: usize> BitAnd<bool> for Mask<T, LANES> where
    T: MaskElement,
    LaneCount<LANES>: SupportedLaneCount, 

type Output = Self

The resulting type after applying the & operator.

fn bitand(self, rhs: bool) -> Self

Performs the & operation.

impl<T, const LANES: usize> BitAndAssign<Mask<T, LANES>> for Mask<T, LANES> where
    T: MaskElement,
    LaneCount<LANES>: SupportedLaneCount, 

fn bitand_assign(&mut self, rhs: Self)

Performs the &= operation.

impl<T, const LANES: usize> BitAndAssign<bool> for Mask<T, LANES> where
    T: MaskElement,
    LaneCount<LANES>: SupportedLaneCount, 

fn bitand_assign(&mut self, rhs: bool)

Performs the &= operation.

impl<T, const LANES: usize> BitOr<Mask<T, LANES>> for Mask<T, LANES> where
    T: MaskElement,
    LaneCount<LANES>: SupportedLaneCount, 

type Output = Self

The resulting type after applying the | operator.

fn bitor(self, rhs: Self) -> Self

Performs the | operation.

impl<T, const LANES: usize> BitOr<Mask<T, LANES>> for bool where
    T: MaskElement,
    LaneCount<LANES>: SupportedLaneCount, 

type Output = Mask<T, LANES>

The resulting type after applying the | operator.

fn bitor(self, rhs: Mask<T, LANES>) -> Mask<T, LANES>

Performs the | operation.

impl<T, const LANES: usize> BitOr<bool> for Mask<T, LANES> where
    T: MaskElement,
    LaneCount<LANES>: SupportedLaneCount, 

type Output = Self

The resulting type after applying the | operator.

fn bitor(self, rhs: bool) -> Self

Performs the | operation.

impl<T, const LANES: usize> BitOrAssign<Mask<T, LANES>> for Mask<T, LANES> where
    T: MaskElement,
    LaneCount<LANES>: SupportedLaneCount, 

fn bitor_assign(&mut self, rhs: Self)

Performs the |= operation.

impl<T, const LANES: usize> BitOrAssign<bool> for Mask<T, LANES> where
    T: MaskElement,
    LaneCount<LANES>: SupportedLaneCount, 

fn bitor_assign(&mut self, rhs: bool)

Performs the |= operation.

impl<T, const LANES: usize> BitXor<Mask<T, LANES>> for Mask<T, LANES> where
    T: MaskElement,
    LaneCount<LANES>: SupportedLaneCount, 

type Output = Self

The resulting type after applying the ^ operator.

fn bitxor(self, rhs: Self) -> Self::Output

Performs the ^ operation.

impl<T, const LANES: usize> BitXor<Mask<T, LANES>> for bool where
    T: MaskElement,
    LaneCount<LANES>: SupportedLaneCount, 

type Output = Mask<T, LANES>

The resulting type after applying the ^ operator.

fn bitxor(self, rhs: Mask<T, LANES>) -> Self::Output

Performs the ^ operation.

impl<T, const LANES: usize> BitXor<bool> for Mask<T, LANES> where
    T: MaskElement,
    LaneCount<LANES>: SupportedLaneCount, 

type Output = Self

The resulting type after applying the ^ operator.

fn bitxor(self, rhs: bool) -> Self::Output

Performs the ^ operation.

impl<T, const LANES: usize> BitXorAssign<Mask<T, LANES>> for Mask<T, LANES> where
    T: MaskElement,
    LaneCount<LANES>: SupportedLaneCount, 

fn bitxor_assign(&mut self, rhs: Self)

Performs the ^= operation.

impl<T, const LANES: usize> BitXorAssign<bool> for Mask<T, LANES> where
    T: MaskElement,
    LaneCount<LANES>: SupportedLaneCount, 

fn bitxor_assign(&mut self, rhs: bool)

Performs the ^= operation.

impl<T, const LANES: usize> Clone for Mask<T, LANES> where
    T: MaskElement,
    LaneCount<LANES>: SupportedLaneCount, 

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T, const LANES: usize> Debug for Mask<T, LANES> where
    T: MaskElement + Debug,
    LaneCount<LANES>: SupportedLaneCount, 

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

Formats the value using the given formatter.

impl<T, const LANES: usize> Default for Mask<T, LANES> where
    T: MaskElement,
    LaneCount<LANES>: SupportedLaneCount, 

fn default() -> Self

Returns the “default value” for a type.

impl<T, const LANES: usize> From<[bool; LANES]> for Mask<T, LANES> where
    T: MaskElement,
    LaneCount<LANES>: SupportedLaneCount, 

fn from(array: [bool; LANES]) -> Self

Performs the conversion.

impl<T, const LANES: usize> From<Mask<T, LANES>> for [bool; LANES] where
    T: MaskElement,
    LaneCount<LANES>: SupportedLaneCount, 

fn from(vector: Mask<T, LANES>) -> Self

Performs the conversion.

impl<const LANES: usize> From<Mask<i16, LANES>> for Mask<i32, LANES> where
    LaneCount<LANES>: SupportedLaneCount, 

fn from(value: Mask<i16, LANES>) -> Self

Performs the conversion.

impl<const LANES: usize> From<Mask<i16, LANES>> for Mask<i64, LANES> where
    LaneCount<LANES>: SupportedLaneCount, 

fn from(value: Mask<i16, LANES>) -> Self

Performs the conversion.

impl<const LANES: usize> From<Mask<i16, LANES>> for Mask<isize, LANES> where
    LaneCount<LANES>: SupportedLaneCount, 

fn from(value: Mask<i16, LANES>) -> Self

Performs the conversion.

impl<const LANES: usize> From<Mask<i16, LANES>> for Mask<i8, LANES> where
    LaneCount<LANES>: SupportedLaneCount, 

fn from(value: Mask<i16, LANES>) -> Self

Performs the conversion.

impl<const LANES: usize> From<Mask<i32, LANES>> for Mask<i64, LANES> where
    LaneCount<LANES>: SupportedLaneCount, 

fn from(value: Mask<i32, LANES>) -> Self

Performs the conversion.

impl<const LANES: usize> From<Mask<i32, LANES>> for Mask<isize, LANES> where
    LaneCount<LANES>: SupportedLaneCount, 

fn from(value: Mask<i32, LANES>) -> Self

Performs the conversion.

impl<const LANES: usize> From<Mask<i32, LANES>> for Mask<i8, LANES> where
    LaneCount<LANES>: SupportedLaneCount, 

fn from(value: Mask<i32, LANES>) -> Self

Performs the conversion.

impl<const LANES: usize> From<Mask<i32, LANES>> for Mask<i16, LANES> where
    LaneCount<LANES>: SupportedLaneCount, 

fn from(value: Mask<i32, LANES>) -> Self

Performs the conversion.

impl<const LANES: usize> From<Mask<i64, LANES>> for Mask<isize, LANES> where
    LaneCount<LANES>: SupportedLaneCount, 

fn from(value: Mask<i64, LANES>) -> Self

Performs the conversion.

impl<const LANES: usize> From<Mask<i64, LANES>> for Mask<i8, LANES> where
    LaneCount<LANES>: SupportedLaneCount, 

fn from(value: Mask<i64, LANES>) -> Self

Performs the conversion.

impl<const LANES: usize> From<Mask<i64, LANES>> for Mask<i16, LANES> where
    LaneCount<LANES>: SupportedLaneCount, 

fn from(value: Mask<i64, LANES>) -> Self

Performs the conversion.

impl<const LANES: usize> From<Mask<i64, LANES>> for Mask<i32, LANES> where
    LaneCount<LANES>: SupportedLaneCount, 

fn from(value: Mask<i64, LANES>) -> Self

Performs the conversion.

impl<const LANES: usize> From<Mask<i8, LANES>> for Mask<i16, LANES> where
    LaneCount<LANES>: SupportedLaneCount, 

fn from(value: Mask<i8, LANES>) -> Self

Performs the conversion.

impl<const LANES: usize> From<Mask<i8, LANES>> for Mask<i32, LANES> where
    LaneCount<LANES>: SupportedLaneCount, 

fn from(value: Mask<i8, LANES>) -> Self

Performs the conversion.

impl<const LANES: usize> From<Mask<i8, LANES>> for Mask<i64, LANES> where
    LaneCount<LANES>: SupportedLaneCount, 

fn from(value: Mask<i8, LANES>) -> Self

Performs the conversion.

impl<const LANES: usize> From<Mask<i8, LANES>> for Mask<isize, LANES> where
    LaneCount<LANES>: SupportedLaneCount, 

fn from(value: Mask<i8, LANES>) -> Self

Performs the conversion.

impl<const LANES: usize> From<Mask<isize, LANES>> for Mask<i8, LANES> where
    LaneCount<LANES>: SupportedLaneCount, 

fn from(value: Mask<isize, LANES>) -> Self

Performs the conversion.

impl<const LANES: usize> From<Mask<isize, LANES>> for Mask<i16, LANES> where
    LaneCount<LANES>: SupportedLaneCount, 

fn from(value: Mask<isize, LANES>) -> Self

Performs the conversion.

impl<const LANES: usize> From<Mask<isize, LANES>> for Mask<i32, LANES> where
    LaneCount<LANES>: SupportedLaneCount, 

fn from(value: Mask<isize, LANES>) -> Self

Performs the conversion.

impl<const LANES: usize> From<Mask<isize, LANES>> for Mask<i64, LANES> where
    LaneCount<LANES>: SupportedLaneCount, 

fn from(value: Mask<isize, LANES>) -> Self

Performs the conversion.

impl<T, const LANES: usize> Not for Mask<T, LANES> where
    T: MaskElement,
    LaneCount<LANES>: SupportedLaneCount, 

type Output = Mask<T, LANES>

The resulting type after applying the ! operator.

fn not(self) -> Self::Output

Performs the unary ! operation.

impl<T, const LANES: usize> PartialEq<Mask<T, LANES>> for Mask<T, LANES> where
    T: MaskElement + PartialEq,
    LaneCount<LANES>: SupportedLaneCount, 

fn eq(&self, other: &Self) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl<T, const LANES: usize> PartialOrd<Mask<T, LANES>> for Mask<T, LANES> where
    T: MaskElement + PartialOrd,
    LaneCount<LANES>: SupportedLaneCount, 

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl<T, const LANES: usize> Copy for Mask<T, LANES> where
    T: MaskElement,
    LaneCount<LANES>: SupportedLaneCount, 

impl<T, const LANES: usize> Select<Mask<<T as SimdElement>::Mask, LANES>> for Simd<T, LANES> where
    T: SimdElement,
    LaneCount<LANES>: SupportedLaneCount, 

impl<T, const LANES: usize> Select<Mask<T, LANES>> for Mask<T, LANES> where
    T: MaskElement,
    LaneCount<LANES>: SupportedLaneCount,