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)
因子运算
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

成员函数

(构造函数)	构造新的数值数组 (公有成员函数)
(析构函数)	析构数值数组 (公有成员函数)
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 (C++26)	可以指定宽度的 basic_simd 的便捷别名模板 (别名模板)
simd_mask (C++26)	可以指定宽度的 basic_simd_mask 的便捷别名模板 (别名模板)
simd (并行性 TS v2)	数据并行向量类型 (类模板)
simd_mask (并行性 TS v2)	元素类型为 bool 的数据并行类型 (类模板)