std::basic_simd, std::simd

 

C++

编译器支持

自由（freestanding）与宿主（hosted）

语言

标准库

标准库头文件

具名要求

特性测试宏 (C++20)

语言支持库

概念库 (C++20)

诊断库

内存管理库

元编程库 (C++11)

通用工具库

容器库

迭代器库

范围库 (C++20)

算法库

字符串库

文本处理库

数值库

日期和时间库

输入/输出库

文件系统库 (C++17)

并发支持库 (C++11)

执行控制库 (C++26)

技术规范

符号索引

外部库

 

数值库

常用数学函数
数学特殊函数 (C++17)
数学常数 (C++20)
基本线性代数算法 (C++26)
数据并行类型 (SIMD) (C++26)
浮点环境 (C++11)
复数
数值数组 (valarray)
伪随机数生成
位操作 (C++20)
因子运算
gcd (C++17)	lcm (C++17)
插值
midpoint (C++20)	lerp (C++20)
饱和算术
add_sat (C++26) sub_sat (C++26) saturate_cast (C++26)	mul_sat (C++26) div_sat (C++26)
通用数值运算
iota (C++11) ranges::iota (C++23) accumulate inner_product adjacent_difference    partial_sum	reduce (C++17) transform_reduce (C++17) inclusive_scan (C++17) exclusive_scan (C++17) transform_inclusive_scan (C++17) transform_exclusive_scan (C++17)

 

数据并行类型 (SIMD)

主要类 basic_simdsimd basic_simd_masksimd_mask 加载和存储标志 simd_flagssimd_flag_defaultsimd_flag_convertsimd_flag_alignedsimd_flag_overaligned    加载和存储 simd_unchecked_loadsimd_partial_load simd_unchecked_storesimd_partial_store 类型转换 simd_chunk simd_chunk_n simd_cat

算法 minmaxminmax clamp simd_select 归约 all_ofany_ofnone_of reducereduce_minreduce_max reduce_min_indexreduce_max_index reduce_count 特性 simd_alignment rebind_simd resize_simd

 

std::basic_simd

成员函数
basic_simd operator[] operator++operator--	operator!operator~operator+operator-
非成员函数
operator+operator-operator*operator/operator%operator&operator|operator^operator<<operator>> operator==operator<operator>	operator+=operator-=operator*=operator/=operator%=operator&=operator|=operator^=operator<<=operator>>= operator!=operator<=operator>=
simd-select(std::basic_simd)

 

定义于头文件 <simd>
template< class T, class Abi = /*native-abi*/<T> > class basic_simd;	(1)	(C++26 起)
template< class T, /*simd-size-type*/ N = /*simd-size-v*/<T, /*native-abi*/<T>> > using simd = basic_simd<T, /*deduce-abi-t*/<T, N>>;	(2)	(C++26 起)

1) std::basic_simd 特化是一种数据并行类型。默认的 ABI 标签在编译时由实现确定。

2) std::simd 是一个别名模板，允许用户指定宽度为特定大小。默认宽度在编译时由实现确定。

basic_simd 的每个特化都是一个完整的类型。该特化为

•  * **启用**，如果 `T` 是一个 可向量化类型，并且存在范围 `[1, 64]` 内的值 `M`，使得 `Abi` 是 deduce-abi-t<T, M>，
•  * **禁用**，如果 `T` 不是可向量化类型，
•  * 否则，如果该特化是否启用，由实现定义。

如果 basic_simd<T, Abi> 被禁用，则该特化拥有所有被删除的默认构造函数、析构函数、复制构造函数和复制赋值函数。此外，只有以下成员类型存在。

如果 basic_simd<T, Abi> 被启用，则 basic_simd<T, Abi> 是 可平凡复制的（TriviallyCopyable）。

模板参数

T	-	元素类型；一个可向量化类型
Abi	-	标签类型，用于确定宽度和存储方式
N	-	数据并行类型的宽度；元素的数量

成员类型

类型	定义
value_type	T
mask_type	std::basic_simd_mask<sizeof(T), Abi>
abi_type	Abi

成员常量

名称	描述
constexpr std::integral_constant<simd-size-type, simd-size-v<T, Abi>> size [静态]	basic_simd 的宽度 (public static 成员常量)

成员函数

(构造函数)	构造一个 basic_simd 对象 (public member function)
operator[]	访问指定的元素 (public member function)
operator++operator++(int)operator--operator--(int)	逐元素递增和递减 (public member function)
operator!operator~operator+operator-	逐元素一元运算符 (public member function)

非成员函数

operator+operator-operator*operator/operator%operator&operator|operator^operator<<operator>> (C++26)	逐元素二元运算符 (函数)
operator+=operator-=operator*=operator/=operator%=operator&=operator|=operator^=operator<<=operator>>= (C++26)	逐元素复合二元运算符 (函数)
operator==operator!=operator>=operator<=operator>operator< (C++26)	逐元素关系运算符 (函数)
simd-select(std::basic_simd) (C++26)	为 simd_select 特化逐元素选择 (仅供说明的函数*)

推导指南

template< class R, class... Ts > basic_simd( R&& r, Ts... ) -> /* 见下文 */;		(C++26 起)

只有当以下条件满足时，推导指南才存在：

•  * R 建模 contiguous_range 和 sized_range，并且
•  * ranges::size(r) 是一个 常量表达式。

推导出的类型等价于 std::simd<ranges::range_value_t<R>, ranges::size(r)>。

注意

建议实现支持 `basic_simd` 的启用特化与适当的实现定义类型之间的显式转换。这些适当的类型是实现中可用的非标准向量类型。

参阅

basic_simd_mask (C++26)	元素类型为 bool 的数据并行类型 (类模板)
simd_mask (C++26)	basic_simd_mask 的便利别名模板，可以指定其宽度 (别名模板)
valarray	数值数组、数组掩码和数组切片 (类模板)