std::valarray<T>::operator[]

配列の単一要素または一部分を取得します。

要素列を返す const オーバーロードは新しい std::valarray を作成します。 非 const オーバーロードは配列要素への参照を保持するクラスを返します。

引数

戻り値

例外

処理系定義の例外が投げられるかもしれません。

事前条件

選択される要素は存在していなければなりません。

ノート

• i および j の適切な値について、以下の性質が成り立ちます。

• 参照は resize 時または配列が破棄されたとき無効になります。

オーバーロード (3,5,7,9) について、関数は std::valarray と異なる戻り値の型を使用して実装することができます。 この場合、その置換型は以下の性質を持ちます。

• std::valarray のすべての const メンバ関数が提供されます。
• 置換型から std::valarray、 std::slice_array、 std::gslice_array、 std::mask_array および std::indirect_array が構築できます。
• const std::valarray& 型の引数を取るすべての関数 ( begin() と end() を除く) (C++11以上) は置換型も受理するべきです。
• const std::valarray& 型の引数を2つ取るすべての関数は const std::valarray& と置換型のすべての組み合わせを受理するべきです。
• 戻り値の型は最も深くネストした引数型より3段以上ネストしたテンプレートを追加しません。

スライス、マスク、間接インデックスアクセスはチェーンしません。 std::mask_array (v[v==n] の型) が operator[] を持たないため、 v[v==n][std::slice(0,5,2)] = x; はエラーです。

例

#include <iostream>
#include <valarray>

int main() 
{
    std::valarray<int> data = {0,1,2,3,4,5,6,7,8,9};

    std::cout << "Initial valarray: ";
    for(int n: data) std::cout << n << ' ';
    std::cout << '\n';

    data[data > 5] = -1; // valarray<bool> overload of operator[]
    // the type of data>5 is std::valarray<bool>
    // the type of data[data>5] is std::mask_array<int>

    std::cout << "After v[v>5]=-1:  ";
    for(std::size_t n = 0; n < data.size(); ++n) 
      std::cout << data[n] << ' ';  // regular operator[]
    std::cout << '\n';
}

Initial valarray: 0 1 2 3 4 5 6 7 8 9 
After v[v>5]=-1:  0 1 2 3 4 5 -1 -1 -1 -1