std:: begin (std::valarray)
|
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.
- die Anforderungen eines mutable LegacyRandomAccessIterator erfüllen,
|
(seit C++20) |
-
einen Member-Typ
value_typebesitzen, derTentspricht, und -
einen Member-Typ
referencebesitzen, derT&entspricht.
- die Anforderungen eines konstanten LegacyRandomAccessIterator erfüllen,
|
(seit C++20) |
-
einen Member-Typ
value_typebesitzen, derTentspricht, und -
einen Member-Typ
referencebesitzen, derconst 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
|
(C++11)
|
spezialisiert
std::end
(Funktions-Template) |