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

const T&               operator[]( std::size_t pos ) const;

T&                     operator[]( std::size_t pos );

std::valarray<T>       operator[]( std::slice slicearr ) const;

std::slice_array<T>    operator[]( std::slice slicearr );

std::valarray<T>       operator[]( const std::gslice& gslicearr ) const;

std::gslice_array<T>   operator[]( const std::gslice& gslicearr );

std::valarray<T>       operator[]( const std::valarray<bool>& boolarr ) const;

std::mask_array<T>     operator[]( const std::valarray<bool>& boolarr );

std::valarray<T>       operator[]( const std::valarray<std::size_t>& indarr ) const;

std::indirect_array<T> operator[]( const std::valarray<std::size_t>& indarr );

Einzelne Elemente oder Teile des Arrays abrufen.

Die const-Überladungen, die Elementsequenzen zurückgeben, erstellen ein neues std::valarray-Objekt. Die nicht-const-Überladungen geben Klassen zurück, die Referenzen auf die Array-Elemente enthalten.

Parameter

Rückgabewert

Exceptions

Kann implementierungsdefinierte Ausnahmen auslösen.

Anmerkungen

Für geeignete std::valarray-Werte a, b und geeignete std::size_t-Werte i, j ergeben alle folgenden Ausdrücke stets true:

Referenzen werden ungültig bei resize() oder wenn das Array zerstört wird.

Für Überladungen (3,5,7,9) kann die Funktion mit einem Rückgabetyp implementiert werden, der sich von std::valarray unterscheidet. In diesem Fall hat der Ersatztyp die folgenden Eigenschaften:

• Alle const Elementfunktionen von std::valarray werden bereitgestellt.
• std::valarray, std::slice_array, std::gslice_array, std::mask_array und std::indirect_array können aus dem Ersatztyp konstruiert werden.
• Für jede Funktion, die ein const std::valarray<T>& akzeptiert, außer begin() und end()(seit C++11), müssen identische Funktionen hinzugefügt werden, die die Ersatztypen akzeptieren;
• Für jede Funktion, die zwei const std::valarray<T>& Argumente akzeptiert, müssen identische Funktionen hinzugefügt werden, die jede Kombination aus const std::valarray<T>& und Ersatztypen akzeptieren.
• Der Rückgabetyp fügt nicht mehr als zwei Ebenen der Templateschachtelung über dem am tiefsten geschachtelten Argumenttyp hinzu.

Slice-/Mask-/Indirekte-Index-Zugriffe verketten nicht: v[v == n][std::slice(0, 5, 2)] = x; ist ein Fehler, da std::mask_array (der Typ von v[v == n]) kein operator[] besitzt.

Beispiel

#include <cstddef>
#include <iomanip>
#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 << std::setw(3) << 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 << std::setw(3) << 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

Fehlerberichte

Die folgenden verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.