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 的数据并行类型 (类模板)