std::valarray

 

C++

コンパイラサポート

フリースタンディングとホスト

言語

標準ライブラリ

標準ライブラリヘッダー

名前付き要件

機能テストマクロ (C++20)

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

メモリ管理ライブラリ

メタプログラミングライブラリ (C++11)

汎用ユーティリティライブラリ

コンテナライブラリ

イテレータライブラリ

Rangesライブラリ (C++20)

アルゴリズムライブラリ

文字列ライブラリ

テキスト処理ライブラリ

数値ライブラリ

日付と時刻ライブラリ

入出力ライブラリ

ファイルシステムライブラリ (C++17)

並行サポートライブラリ (C++11)

実行制御ライブラリ (C++26)

Technical specifications (技術仕様)

シンボルインデックス

外部ライブラリ

 

数値ライブラリ

共通の数学関数
数学特殊関数 (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];を実行する単一のループとして最適化し、一時オブジェクトや複数回のパスを回避することが可能になります。しかし、Expression Templateは任意のC++コンテナで同じ最適化技術を可能にするため、大半の数値計算ライブラリは柔軟性の観点からvalarrayよりもExpression Templateを好んで使用します。一部のC++標準ライブラリ実装では、std::valarrayの効率的な操作を実装するためにExpression Templateを使用しています（例：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 アルゴリズムを特殊化する (function template)
std::begin(std::valarray) (C++11)	std::begin をオーバーロードする (function template)
std::end(std::valarray) (C++11)	std::end を特殊化する (function template)
operator+operator-operator*operator/operator%operator&operator|operator^operator<<operator>>operator&&operator||	2つのvalarray、またはvalarrayと値の各要素に二項演算子を適用する (function template)
operator==operator!=operator<operator<=operator>operator>=	2つのvalarray、またはvalarrayと値を比較する (function template)
abs(std::valarray)	valarrayの各要素に関数absを適用する (function template)
指数関数
exp(std::valarray)	valarrayの各要素に関数std::expを適用する (function template)
log(std::valarray)	valarrayの各要素に関数std::logを適用する (function template)
log10(std::valarray)	valarrayの各要素に関数std::log10を適用する (function template)
べき乗関数
pow(std::valarray)	2つのvalarray、またはvalarrayと値に関数std::powを適用する (function template)
sqrt(std::valarray)	valarrayの各要素に関数std::sqrtを適用する (function template)
三角関数
sin(std::valarray)	valarrayの各要素に関数std::sinを適用する (function template)
cos(std::valarray)	valarrayの各要素に関数std::cosを適用する (function template)
tan(std::valarray)	valarrayの各要素に関数std::tanを適用する (function template)
asin(std::valarray)	valarrayの各要素に関数std::asinを適用する (function template)
acos(std::valarray)	valarrayの各要素に関数std::acosを適用する (function template)
atan(std::valarray)	valarrayの各要素に関数std::atanを適用する (function template)
atan2(std::valarray)	valarrayと値に関数std::atan2を適用する (function template)
双曲線関数
sinh(std::valarray)	valarrayの各要素に関数std::sinhを適用する (function template)
cosh(std::valarray)	valarrayの各要素に関数std::coshを適用する (function template)
tanh(std::valarray)	valarrayの各要素に関数std::tanhを適用する (function template)

ヘルパークラス

slice	valarrayのBLAS風スライス: 開始インデックス、長さ、ストライド (class)
slice_array	スライスを適用した後のvalarrayのサブセットへのプロキシ (class template)
gslice	valarrayの汎用スライス: 開始インデックス、長さの集合、ストライドの集合 (class)
gslice_array	gsliceを適用した後のvalarrayのサブセットへのプロキシ (class template)
mask_array	真偽値マスクのoperator[]を適用した後のvalarrayのサブセットへのプロキシ (class template)
indirect_array	間接operator[]を適用した後のvalarrayのサブセットへのプロキシ (class template)

関連項目

simd (C++26)	basic_simd のための、幅を指定できる便利なエイリアステンプレート (エイリアステンプレート)
simd_mask (C++26)	basic_simd_mask のための、幅を指定できる便利なエイリアステンプレート (エイリアステンプレート)
simd (parallelism TS v2)	データ並列ベクトル型 (class template)
simd_mask (parallelism TS v2)	要素型がboolのデータ並列型 (class template)