std::valarray

 

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)

 

std::valarray

成員函式
valarray::valarray valarray::~valarray valarray::operator= valarray::operator[] valarray::swap valarray::size valarray::resize valarray::sum valarray::min valarray::max valarray::shift valarray::cshift valarray::apply	valarray::operator+valarray::operator-valarray::operator~valarray::operator! valarray::operator+=valarray::operator-=valarray::operator*=valarray::operator/=valarray::operator%=valarray::operator&=valarray::operator|=valarray::operator^=valarray::operator<<=valarray::operator>>=
非成員函式
swap(std::valarray) (C++11) begin(std::valarray) (C++11)   end(std::valarray) (C++11) abs exp log log10 pow sqrt sin cos tan asin acos atan atan2 sinh cosh tanh	operator*operator/operator%operator+operator-operator^operator&operator|operator<<operator>>operator&&operator|| operator==operator!=operator<operator>operator<=operator>=
輔助類
slice_array gslice_array indirect_array	slice gslice mask_array
推導指南 (C++17 起)

 

定義於標頭檔案 <valarray>
template< class T > class valarray;

std::valarray 是用於表示和操作值陣列的類。它支援元素級的數學運算以及各種形式的廣義下標運算子、切片和間接訪問。

注意

std::valarray 和輔助類被定義為免受某些形式的別名干擾，從而允許對這些類的操作進行最佳化，類似於 C 程式語言中關鍵字 restrict 的效果。此外，接受 valarray 引數的函式和運算子允許返回代理物件，以便編譯器可以將諸如 v1 = a * v2 + v3; 之類的表示式最佳化為單個迴圈，執行 v1[i] = a * v2[i] + v3[i];，避免任何臨時變數或多重遍歷。然而，表示式模板 使相同的最佳化技術可用於任何 C++ 容器，並且大多數數值庫傾向於使用表示式模板而不是 valarray 以獲得靈活性。一些 C++ 標準庫實現使用表示式模板來實現對 std::valarray 的高效操作（例如 GNU libstdc++ 和 LLVM libc++）。只有極少數情況下 valarray 會進一步最佳化，例如 Intel Integrated Performance Primitives。

模板引數

T

-

元素型別。該型別必須滿足 NumericType 要求

成員型別

成員型別	定義
value_type	T

成員函式

(建構函式)	構造新的數值陣列 (public member function)
(解構函式)	銷燬數值陣列 (public member function)
operator=	賦值內容 (public member function)
operator[]	獲取/設定 valarray 元素、切片或掩碼 (public member function)
operator+operator-operator~operator!	對 valarray 的每個元素應用一元算術運算子 (public member function)
operator+=operator-=operator*=operator/=operator%=operator&=operator|=operator^=operator<<=operator>>=	將複合賦值運算子應用於 valarray 的每個元素 (public member function)
swap	與另一個 valarray 交換 (public member function)
size	返回 valarray 的大小 (public member function)
resize	改變 valarray 的大小 (public member function)
sum	計算所有元素的和 (public member function)
min	返回最小元素 (public member function)
max	返回最大元素 (public member function)
shift	對 valarray 的元素進行零填充移位 (public member function)
cshift	對 valarray 的元素進行迴圈移位 (public member function)
apply	將函式應用於 valarray 的每個元素 (public member function)

非成員函式

std::swap(std::valarray) (C++11)	特化 std::swap 演算法 (函式模板)
std::begin(std::valarray) (C++11)	過載 std::begin (函式模板)
std::end(std::valarray) (C++11)	特化 std::end (函式模板)
operator+operator-operator*operator/operator%operator&operator|operator^operator<<operator>>operator&&operator||	對兩個 valarray 的每個元素，或一個 valarray 和一個值應用二元運算子 (函式模板)
operator==operator!=operator<operator<=operator>operator>=	比較兩個 valarray 或一個 valarray 與一個值 (函式模板)
abs(std::valarray)	將函式 abs 應用於 valarray 的每個元素 (函式模板)
指數函式
exp(std::valarray)	將函式 std::exp 應用於 valarray 的每個元素 (函式模板)
log(std::valarray)	將函式 std::log 應用於 valarray 的每個元素 (函式模板)
log10(std::valarray)	將函式 std::log10 應用於 valarray 的每個元素 (函式模板)
冪函式
pow(std::valarray)	將函式 std::pow 應用於兩個 valarray 或一個 valarray 和一個值 (函式模板)
sqrt(std::valarray)	將函式 std::sqrt 應用於 valarray 的每個元素 (函式模板)
三角函式
sin(std::valarray)	將函式 std::sin 應用於 valarray 的每個元素 (函式模板)
cos(std::valarray)	將函式 std::cos 應用於 valarray 的每個元素 (函式模板)
tan(std::valarray)	將函式 std::tan 應用於 valarray 的每個元素 (函式模板)
asin(std::valarray)	將函式 std::asin 應用於 valarray 的每個元素 (函式模板)
acos(std::valarray)	將函式 std::acos 應用於 valarray 的每個元素 (函式模板)
atan(std::valarray)	將函式 std::atan 應用於 valarray 的每個元素 (函式模板)
atan2(std::valarray)	將函式 std::atan2 應用於一個 valarray 和一個值 (函式模板)
雙曲函式
sinh(std::valarray)	將函式 std::sinh 應用於 valarray 的每個元素 (函式模板)
cosh(std::valarray)	將函式 std::cosh 應用於 valarray 的每個元素 (函式模板)
tanh(std::valarray)	將函式 std::tanh 應用於 valarray 的每個元素 (函式模板)

輔助類

slice	valarray 的類 BLAS 切片：起始索引、長度、步長 (類)
slice_array	應用切片後 valarray 子集的代理 (類模板)
gslice	valarray 的廣義切片：起始索引、長度集、步長集 (類)
gslice_array	應用 gslice 後 valarray 子集的代理 (類模板)
mask_array	應用布林掩碼 operator[] 後 valarray 子集的代理 (類模板)
indirect_array	應用間接 operator[] 後 valarray 子集的代理 (類模板)

參見

simd (C++26)	basic_simd 的便利別名模板，可以指定其寬度 (別名模板)
simd_mask (C++26)	basic_simd_mask 的便利別名模板，可以指定其寬度 (別名模板)
simd (並行技術規範 v2)	資料並行向量型別 (類模板)
simd_mask (並行技術規範 v2)	元素型別為 bool 的資料並行型別 (類模板)