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

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 halten.

Parameter

Rückgabewert

Exceptions

Kann implementierungsdefinierte Ausnahmen auslösen.

Hinweise

Für korrekte std::valarray Werte a , b und korrekte std::size_t Werte i , j , evaluieren alle der folgenden Ausdrücke immer zu 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 besitzt der Ersatztyp folgende Eigenschaften:

• Alle const Memberfunktionen 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 > & außer begin() und end() (seit C++11) akzeptiert, 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 von const std:: valarray < T > & und Ersatztypen akzeptieren.
• Der Rückgabetyp fügt nicht mehr als zwei Ebenen von Template-Verschachtelung über dem am tiefsten verschachtelten Argumenttyp hinzu.

Slice/Mask/Indirekte Indexzugriffe lassen sich nicht verketten: v [ v == n ] [ std:: slice ( 0 , 5 , 2 ) ] = x ; ist ein Fehler, weil std::mask_array (der Typ von v [ v == n ] ) keinen 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.