std::valarray

 

C++

编译器支持

自立实现与有宿主实现

语言

标准库

标准库标头

具名要求

功能特性测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

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

并发支持库 (C++11)

技术规范

符号索引

外部库

 

数值库

常用数学函数
数学特殊函数 (C++17)
数学常数 (C++20)
基本线性代数算法 (C++26)
浮点环境 (C++11)
复数
数值数组 (valarray)
伪随机数生成
因数运算
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)
位操作
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++ 容器可用，而数值库的主流则因灵活性而偏好表达式模板甚于 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)	对 valarray 的每个元素应用 std::sin 函数 (函数模板)
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)	对 valarray 的每个元素应用 std::sinh 函数 (函数模板)
cosh(std::valarray)	应用函数 std::cosh 到 valarray 的每个元素 (函数模板)
tanh(std::valarray)	在 valarray 的每个元素上调用 std::tanh 函数 (函数模板)

辅助类

slice	valarray 的 BLAS 式切片：起始下标、长度、跨度 (类)
slice_array	到 valarray 应用切片后的子集的代理 (类模板)
gslice	valarray 的通用切片：起始下标、长度集、步幅集 (类)
gslice_array	valarray 应用 gslice 后的子集的代理 (类模板)
mask_array	到应用布尔掩码 operator[] 后的 valarray 子集的代理 (类模板)
indirect_array	到应用间接 operator[] 后的 valarray 子集的代理。 (类模板)

参阅

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