std::begin(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)

 

template< class T > /* 以下参照 */ begin( valarray<T>& v );	(1)	(C++11以降)
template< class T > /* 以下参照 */ begin( const valarray<T>& v );	(2)	(C++11以降)

valarray に対する std::begin のオーバーロードは、数値配列の最初の要素を参照する、型が未指定のイテレータを返します。

1) 返される型は

• ミュータブルな LegacyRandomAccessIterator の要件を満たし、

contiguous_iterator をモデル化し、

(C++20以降)

• メンバー型 value_type は T であり、
• メンバー型 reference は T& でなければなりません。

2) 返される型は

• コンスタントな LegacyRandomAccessIterator の要件を満たし、

contiguous_iterator をモデル化し、

(C++20以降)

• メンバー型 value_type は T であり、
• メンバー型 reference は const T& でなければなりません。

この関数から返されるイテレータは、v に対してメンバー関数 resize() が呼び出されたとき、または v の寿命が尽きたときに無効になります（いずれかが先に発生した場合）。

パラメータ

v

-

数値配列

戻り値

数値配列の最初の値へのイテレータ。

例外

実装定義の例外をスローする場合があります。

注記

std::valarray 引数を受け取る他の関数とは異なり、begin() は、valarray を含む式から返される可能性のある置換型（式テンプレートによって生成される型など）を受け入れることはできません。std::begin(v1 + v2) は移植性がなく、代わりに std::begin(std::valarray<T>(v1 + v2)) を使用する必要があります。

この関数の意図は、valarray で範囲 for ループ を使用できるようにすることであり、コンテナとしてのセマンティクスを提供することではありません。

例

このコードを実行

#include <algorithm>
#include <iostream>
#include <valarray>
 
void show(const std::valarray<int>& v)
{
    std::for_each(std::begin(v), std::end(v), [](int c)
    {
        std::cout << c << ' ';
    });
    std::cout << '\n';
};
 
int main()
{
    const std::valarray<int> x{47, 70, 37, 52, 90, 23, 17, 33, 22, 16, 21, 4};
    const std::valarray<int> y{25, 31, 71, 56, 21, 21, 15, 34, 21, 27, 12, 6};
 
    show(x); 
    show(y); 
 
    const std::valarray<int> z{x + y};
 
    for (char c : z)
        std::cout << c;
}

出力

47 70 37 52 90 23 17 33 22 16 21 4 
25 31 71 56 21 21 15 34 21 27 12 6 
Hello, C++!

不具合報告

以下の動作変更を伴う欠陥報告が、以前に公開されたC++標準に遡って適用されました。

DR	適用対象	公開された動作	正しい動作
LWG 2058	C++11	1. begin() は置換型をサポートする必要があった 2. 返されたイテレータが無効になる時期が未指定であった	1. 必要ない 2. 指定された

関連項目

std::end(std::valarray) (C++11)

std::end を特殊化する (function template)