std::valarray<T>::begin

iterator       begin();

const_iterator begin() const;

Gibt einen Iterator zurück, der auf das erste Element im numerischen Array verweist.

Der von dieser Funktion zurückgegebene Iterator wird ungültig, wenn die Mitgliedsfunktion resize() auf v aufgerufen wird oder wenn die Lebensdauer von v endet, je nachdem, was zuerst eintritt.

Parameter

Rückgabewert

Iterator zum ersten Element im numerischen Array.

Ausnahmen

Kann implementationsdefinierte Ausnahmen werfen.

Hinweise

Anders als andere Funktionen, die std::valarray-Argumente akzeptieren, kann begin() die Ersatztypen (wie die von Ausdrucksvorlagen erzeugten Typen) nicht akzeptieren, die möglicherweise von Ausdrücken mit Valarrays zurückgegeben werden: (v1 + v2).begin() ist nicht portabel, stattdessen muss std::valarray<T>(v1 + v2).begin() verwendet werden.

Der Zweck dieser Funktion ist es, Bereichs-for-Schleifen mit Valarrays zu ermöglichen, nicht um Containersemantik bereitzustellen.

Beispiel

#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++!

Fehlerberichte

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

Siehe auch