std::valarray<T>::begin
提供: ja.cppreference.net
iterator begin();
|
(1) | (C++11以降) |
const_iterator begin() const;
|
(2) | (C++11以降) |
数値配列の最初の要素を指すイテレータを返します。
この関数から返されたイテレータは、メンバ関数resize()がvに対して呼び出されたとき、またはvの生存期間が終了したときの、いずれか先に発生した時点で無効になります。
引数
| v | - | 数値配列 |
戻り値
数値配列の最初の要素へのイテレータ。
例外
処理系定義の例外を投げる可能性があります。
注記
std::valarray引数を取る他の関数とは異なり、begin()は、valarray を含む式から返される可能性がある置換型（式テンプレートによって生成される型など）を受け入れることができません。(v1 + v2).begin()は移植性がなく、代わりにstd::valarray<T>(v1 + v2).begin()を使用する必要があります。
この関数の意図は、valarray で範囲 for ループを動作させることであり、コンテナのセマンティクスを提供することではありません。
例
このコードを実行する
#include <algorithm>
#include <iostream>
#include <valarray>
void show(const std::valarray<int>& v)
{
std::for_each(v.begin(), v.end(), [](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. 規定された |
| P3016R6 | C++11 | 非メンバのbegin()関数が範囲アクセスに不整合を導入した
|
begin()をメンバ関数に変更
|
関連項目
(C++11) |
valarray の終端イテレータを取得する (公開メンバ関数) |