mask64x64 in core::simd - Rust
Description: A SIMD mask with 64 elements for vectors with 64-bit element types.

# Type Alias core::simd::mask64x64

source ·

    pub type mask64x64 = Mask<i64, 64>;

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

A SIMD mask with 64 elements for vectors with 64-bit element types.

The layout of this type is unspecified, and may change between platforms and/or Rust versions, and code should not assume that it is equivalent to `[i64; 64]`.

## Aliased Type§

    struct mask64x64(/* private fields */);

## Implementations§

source§

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

source

#### 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.

source

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

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

Converts an array of bools to a SIMD mask.

source

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

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

Converts a SIMD mask to an array of bools.

source

#### 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.

source

#### 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.

source

#### 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`.

source

#### pub fn cast<U: MaskElement>(self) -> Mask<U, LANES>

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

Converts the mask to a mask of any other lane size.

source

#### 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`.

source

#### 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.

source

#### 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`.

source

#### 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.

source

#### 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.

source

#### 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.

source§

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

source

#### pub fn select<U>( self, true_values: Simd<U, LANES>, false_values: Simd<U, LANES> ) -> Simd<U, LANES>where U: SimdElement<Mask = T>,

🔬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.

##### Examples

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

Run
source

#### pub fn select_mask(self, true_values: Self, false_values: Self) -> Self

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

Choose lanes from two masks.

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.

##### Examples

    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_mask(a, b);
    assert_eq!(c.to_array(), [true, false, true, false]);

Run

## Trait Implementations§

source§

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

§

#### type Output = Mask<T, LANES>

The resulting type after applying the `&` operator.
source§

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

Performs the `&` operation. Read more
source§

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

§

#### type Output = Mask<T, LANES>

The resulting type after applying the `&` operator.
source§

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

Performs the `&` operation. Read more
source§

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

source§

#### fn bitand_assign(&mut self, rhs: Self)

Performs the `&=` operation. Read more
source§

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

source§

#### fn bitand_assign(&mut self, rhs: bool)

Performs the `&=` operation. Read more
source§

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

§

#### type Output = Mask<T, LANES>

The resulting type after applying the `|` operator.
source§

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

Performs the `|` operation. Read more
source§

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

§

#### type Output = Mask<T, LANES>

The resulting type after applying the `|` operator.
source§

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

Performs the `|` operation. Read more
source§

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

source§

#### fn bitor_assign(&mut self, rhs: Self)

Performs the `|=` operation. Read more
source§

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

source§

#### fn bitor_assign(&mut self, rhs: bool)

Performs the `|=` operation. Read more
source§

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

§

#### type Output = Mask<T, LANES>

The resulting type after applying the `^` operator.
source§

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

Performs the `^` operation. Read more
source§

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

§

#### type Output = Mask<T, LANES>

The resulting type after applying the `^` operator.
source§

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

Performs the `^` operation. Read more
source§

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

source§

#### fn bitxor_assign(&mut self, rhs: Self)

Performs the `^=` operation. Read more
source§

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

source§

#### fn bitxor_assign(&mut self, rhs: bool)

Performs the `^=` operation. Read more
source§

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

source§

#### fn clone(&self) -> Self

Returns a copy of the value. Read more
1.0.0 · source§

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

Performs copy-assignment from `source`. Read more
source§

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

source§

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

Formats the value using the given formatter. Read more
source§

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

source§

#### fn default() -> Self

Returns the “default value” for a type. Read more
source§

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

source§

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

Converts to this type from the input type.
source§

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

source§

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

Converts to this type from the input type.
source§

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

source§

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

Converts to this type from the input type.
source§

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

source§

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

Converts to this type from the input type.
source§

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

source§

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

Converts to this type from the input type.
source§

### 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.
source§

#### fn not(self) -> Self::Output

Performs the unary `!` operation. Read more
source§

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

source§

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

This method tests for `self` and `other` values to be equal, and is used by `==`.
1.0.0 · source§

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

This method tests for `!=`. The default implementation is almost always sufficient, and should not be overridden without very good reason.
source§

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

source§

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

This method returns an ordering between `self` and `other` values if one exists. Read more
1.0.0 · source§

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

This method tests less than (for `self` and `other`) and is used by the `<` operator. Read more
1.0.0 · source§

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

This method tests less than or equal to (for `self` and `other`) and is used by the `<=` operator. Read more
1.0.0 · source§

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

This method tests greater than (for `self` and `other`) and is used by the `>` operator. Read more
1.0.0 · source§

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

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

### impl<const LANES: usize> SimdOrd for Mask<i64, LANES>where LaneCount<LANES>: SupportedLaneCount,

source§

#### fn simd_max(self, other: Self) -> Self

🔬This is a nightly-only experimental API. (`portable_simd` #86656)
Returns the lane-wise maximum with `other`.
source§

#### fn simd_min(self, other: Self) -> Self

🔬This is a nightly-only experimental API. (`portable_simd` #86656)
Returns the lane-wise minimum with `other`.
source§

#### fn simd_clamp(self, min: Self, max: Self) -> Self

🔬This is a nightly-only experimental API. (`portable_simd` #86656)
Restrict each lane to a certain interval. Read more
source§

### impl<const LANES: usize> SimdPartialEq for Mask<i64, LANES>where LaneCount<LANES>: SupportedLaneCount,

§

#### type Mask = Mask<i64, LANES>

🔬This is a nightly-only experimental API. (`portable_simd` #86656)
The mask type returned by each comparison.
source§

#### fn simd_eq(self, other: Self) -> Self::Mask

🔬This is a nightly-only experimental API. (`portable_simd` #86656)
Test if each lane is equal to the corresponding lane in `other`.
source§

#### fn simd_ne(self, other: Self) -> Self::Mask

🔬This is a nightly-only experimental API. (`portable_simd` #86656)
Test if each lane is equal to the corresponding lane in `other`.
source§

### impl<const LANES: usize> SimdPartialOrd for Mask<i64, LANES>where LaneCount<LANES>: SupportedLaneCount,

source§

#### fn simd_lt(self, other: Self) -> Self::Mask

🔬This is a nightly-only experimental API. (`portable_simd` #86656)
Test if each lane is less than the corresponding lane in `other`.
source§

#### fn simd_le(self, other: Self) -> Self::Mask

🔬This is a nightly-only experimental API. (`portable_simd` #86656)
Test if each lane is less than or equal to the corresponding lane in `other`.
source§

#### fn simd_gt(self, other: Self) -> Self::Mask

🔬This is a nightly-only experimental API. (`portable_simd` #86656)
Test if each lane is greater than the corresponding lane in `other`.
source§

#### fn simd_ge(self, other: Self) -> Self::Mask

🔬This is a nightly-only experimental API. (`portable_simd` #86656)
Test if each lane is greater than or equal to the corresponding lane in `other`.
source§

### impl<T: MaskElement> ToBitMask for Mask<T, 64>

§

#### type BitMask = u64

🔬This is a nightly-only experimental API. (`portable_simd` #86656)
The integer bitmask type.
source§

#### fn to_bitmask(self) -> u64

🔬This is a nightly-only experimental API. (`portable_simd` #86656)
Converts a mask to a bitmask.
source§

#### fn from_bitmask(bitmask: u64) -> Self

🔬This is a nightly-only experimental API. (`portable_simd` #86656)
Converts a bitmask to a mask.
source§

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