std::valarray

 

C++

編譯器支持

自立實現與有宿主實現

語言

標準庫

標準庫標頭

具名要求

功能特性測試宏 (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)
飽和算術 (C++26)
因數運算
gcd (C++17)	lcm (C++17)
插值
midpoint (C++20)	lerp (C++20)
泛型算術運算
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)
C 風格帶檢查整數算術
ckd_add (C++26) ckd_sub (C++26)	ckd_mul (C++26)

 

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

成員函數

(構造函數)	構造新的數值數組 (公開成員函數)
(析構函數)	析構數值數組 (公開成員函數)
operator=	為內容賦值 (公開成員函數)
operator[]	獲取/設置 valarray 數組元素、切片或掩碼 (公開成員函數)
operator+operator-operator~operator!	對 valarray 的每個元素運用一元算術運算符 (公開成員函數)
operator+=operator-=operator*=operator/=operator%=operator&=operator|=operator^=operator<<=operator>>=	對 valarray 的每個元素應用複合賦值運算符 (公開成員函數)
swap	與另一 valarray 交換 (公開成員函數)
size	返回 valarray 的大小 (公開成員函數)
resize	更改 valarray 的大小 (公開成員函數)
sum	計算所有元素的和 (公開成員函數)
min	返回最小元素 (公開成員函數)
max	返回最大的元素 (公開成員函數)
shift	以填入零的方式移動 valarray 的元素 (公開成員函數)
cshift	循環移動 valarray 的元素 (公開成員函數)
apply	對 valarray 的每個元素應用一個函數 (公開成員函數)

非成員函數

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>=	比較兩個 valarrays，或比較一個 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	valarray 應用 gslice 後的子集的代理 (類模板)
mask_array	到應用布爾掩碼 operator[] 後的 valarray 子集的代理 (類模板)
indirect_array	到應用間接 operator[] 後的 valarray 子集的代理。 (類模板)

參閱

datapar::simd (C++26)	可以指定寬度的 basic_simd 的便利別名模板 (別名模板)
datapar::simd_mask (C++26)	可以指定寬度的 basic_simd_mask 的便利別名模板 (別名模板)
simd (並行 TS v2)	數據並行向量類型 (類模板)
simd_mask (並行 TS v2)	元素類型為 bool 的數據並行類型 (類模板)