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)

Element 指定宽度的 LANES 元素的 SIMD vector 掩码。

这种类型的布局是未指定的。

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)

通过将所有 lanes 设置为给定值来构建掩码。

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

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

将数组转换为 SIMD vector。

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

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

将 SIMD vector 转换为数组。

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

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

将整数 vector 转换为掩码，其中 0 代表 false，-1 代表 true。

Safety

所有 lanes 必须为 0 或 -1。

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

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

将整数 vector 转换为掩码，其中 0 代表 false，-1 代表 true。

Panics

如果任何 lane 不是 0 或 -1，就会出现 panics。

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

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

将掩码转换为整数 vector，其中 0 代表 false，-1 代表 true。

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

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

测试指定 lane 的值。

Safety

lane 必须小于 LANES。

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

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

测试指定 lane 的值。

Panics

如果 lane 大于或等于 vector 中的 lane 数，则出现 panics。

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

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

设置指定 lane 的值。

Safety

lane 必须小于 LANES。

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

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

设置指定 lane 的值。

Panics

如果 lane 大于或等于 vector 中的 lane 数，则出现 panics。

pub fn any(self) -> bool

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

如果设置了任何 lane，则返回 true，否则返回 false。

pub fn all(self) -> bool

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

如果设置了所有 lanes，则返回 true，否则返回 false。

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

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)

从两个 vectors 中选择 lanes。

对于掩码中的每个 lane，如果该 lane 的掩码为 true，则从 true_values 中选择相应的 lane，如果该 lane 的掩码为 false，则从 false_values 中选择相应的 lane。

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

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

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

从两个掩码中选择 lanes。

对于掩码中的每个 lane，如果该 lane 的掩码为 true，则从 true_values 中选择相应的 lane，如果该 lane 的掩码为 false，则从 false_values 中选择相应的 lane。

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

Trait Implementations

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

type Output = Self

应用 & 运算符后的结果类型。

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

执行 & 操作。

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

type Output = Mask<T, LANES>

应用 & 运算符后的结果类型。

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

执行 & 操作。

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

type Output = Self

应用 & 运算符后的结果类型。

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

执行 & 操作。

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)

执行 &= 操作。

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

fn bitand_assign(&mut self, rhs: bool)

执行 &= 操作。

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

type Output = Self

应用 | 运算符后的结果类型。

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

执行 | 操作。

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

type Output = Mask<T, LANES>

应用 | 运算符后的结果类型。

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

执行 | 操作。

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

type Output = Self

应用 | 运算符后的结果类型。

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

执行 | 操作。

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)

执行 |= 操作。

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

fn bitor_assign(&mut self, rhs: bool)

执行 |= 操作。

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

type Output = Self

应用 ^ 运算符后的结果类型。

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

执行 ^ 操作。

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

type Output = Mask<T, LANES>

应用 ^ 运算符后的结果类型。

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

执行 ^ 操作。

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

type Output = Self

应用 ^ 运算符后的结果类型。

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

执行 ^ 操作。

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)

执行 ^= 操作。

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

fn bitxor_assign(&mut self, rhs: bool)

执行 ^= 操作。

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

fn clone(&self) -> Self

返回值的副本。

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

从 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

使用给定的格式化程序格式化该值。

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

fn default() -> Self

返回类型的 “默认值”。

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

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

执行转换。

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

执行转换。

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

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

执行转换。

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

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

执行转换。

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

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

执行转换。

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

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

执行转换。

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

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

执行转换。

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

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

执行转换。

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

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

执行转换。

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

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

执行转换。

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

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

执行转换。

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

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

执行转换。

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

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

执行转换。

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

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

执行转换。

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

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

执行转换。

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

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

执行转换。

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

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

执行转换。

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

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

执行转换。

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

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

执行转换。

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

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

执行转换。

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

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

执行转换。

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

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

执行转换。

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

type Output = Mask<T, LANES>

应用 ! 运算符后的结果类型。

fn not(self) -> Self::Output

执行一元 ! 操作。

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

此方法测试 self 和 other 值是否相等，并由 == 使用。

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

此方法测试 !=。

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>

如果存在，则此方法返回 self 和 other 值之间的顺序。

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

此方法测试的内容少于 (对于 self 和 other)，并且由 < 操作员使用。

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

此方法测试小于或等于 (对于 self 和 other)，并且由 <= 运算符使用。

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

此方法测试大于 (对于 self 和 other)，并且由 > 操作员使用。

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

此方法测试是否大于或等于 (对于 self 和 other)，并且由 >= 运算符使用。

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