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	數值陣列、陣列掩碼和陣列切片 (類模板)