Namespaces
Variants

std:: begin (std::valarray)

From cppreference.net
template < class T >
/* siehe unten */ begin ( valarray < T > & v ) ;
(1) (seit C++11)
template < class T >
/* siehe unten */ begin ( const valarray < T > & v ) ;
(2) (seit C++11)

Die Überladung von std::begin für valarray gibt einen Iterator nicht näher spezifizierten Typs zurück, der auf das erste Element im numerischen Array verweist.

1) Der Rückgabetyp muss
(seit C++20)
  • einen Member-Typ value_type besitzen, der T entspricht, und
  • einen Member-Typ reference besitzen, der T& entspricht.
2) Der Rückgabetyp muss
(seit C++20)
  • einen Member-Typ value_type besitzen, der T entspricht, und
  • einen Member-Typ reference besitzen, der const T& entspricht.

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

Inhaltsverzeichnis

Parameter

v - ein numerisches Array

Rückgabewert

Iterator zum ersten Wert im numerischen Array.

Ausnahmen

Kann implementierungsdefinierte Ausnahmen auslösen.

Hinweise

Im Gegensatz zu anderen Funktionen, die std::valarray Argumente akzeptieren, begin() kann keine Ersatztypen (wie die von Ausdrucksvorlagen erzeugten Typen) annehmen, die von Ausdrücken mit valarrays zurückgegeben werden können: std:: begin ( v1 + v2 ) ist nicht portabel, std:: begin ( std:: valarray < T > ( v1 + v2 ) ) muss stattdessen verwendet werden.

Die Absicht dieser Funktion ist es, Range-for-Schleifen die Arbeit mit Valarrays zu ermöglichen, nicht Containersemantik bereitzustellen.

Beispiel

#include <algorithm>
#include <iostream>
#include <valarray>
void show(const std::valarray<int>& v)
{
    std::for_each(std::begin(v), std::end(v), [](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;
}

Ausgabe:

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.

DR Angewendet auf Verhalten wie veröffentlicht Korrigiertes Verhalten
LWG 2058 C++11 1. begin() musste Ersatztypen unterstützen
2. es war nicht spezifiziert, wann die zurückgegebenen Iteratoren ungültig werden
1. nicht erforderlich
2. spezifiziert

Siehe auch

spezialisiert std::end
(Funktions-Template)