std::valarray

 

C++

编译器支持

独立和托管

语言

标准库

标准库头文件

命名要求

特性测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用实用程序库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

正则表达式库 (C++11)

并发支持库 (C++11)

执行支持库 (C++26)

技术规范

符号索引

外部库

 

数值库

常见数学函数
数学特殊函数 (C++17)
数学常数 (C++20)
基本线性代数算法 (C++26)
浮点环境 (C++11)
复数
数值数组 (valarray)
伪随机数生成
因式运算
gcd (C++17)	lcm (C++17)
插值
中点 (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)
位运算
has_single_bit (C++20)     bit_cast (C++20) bit_ceil (C++20) bit_floor (C++20) bit_width (C++20) rotl (C++20) rotr (C++20)	popcount (C++20) countl_zero (C++20) countl_one (C++20) countr_zero (C++20) countr_one (C++20) byteswap (C++23) endian (C++20)

 

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++ 容器，并且大多数数值库更喜欢表达式模板而不是 valarrays 来获得灵活性。一些 C++ 标准库实现使用表达式模板来实现对 std::valarray 的高效操作（例如 GNU libstdc++ 和 LLVM libc++）。很少有 valarrays 进行进一步优化，例如在 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>=	比较两个 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	类似 BLAS 的 valarray 片段：起始索引、长度、步长 (类)
slice_array	应用片段后对 valarray 的子集的代理 (类模板)
gslice	valarray 的泛化片段：起始索引、长度集、步长集 (类)
gslice_array	应用 gslice 后对 valarray 的子集的代理 (类模板)
mask_array	应用布尔掩码 operator[] 后对 valarray 的子集的代理 (类模板)
indirect_array	应用间接 operator[] 后对 valarray 的子集的代理 (类模板)

另请参阅

simd (并行 TS v2)	数据并行向量类型 (类模板)
simd_mask (并行 TS v2)	元素类型为 bool 的数据并行类型 (类模板)