std:: end (std::valarray)
|
template
<
class
T
>
/* siehe unten */ end ( valarray < T > & v ) ; |
(1) | (seit C++11) |
|
template
<
class
T
>
/* siehe unten */ end ( const valarray < T > & v ) ; |
(2) | (seit C++11) |
Die Überladung von
std::end
für
valarray
gibt einen Iterator nicht näher spezifizierten Typs zurück, der auf das Element nach dem letzten Element im numerischen Array verweist.
- die Anforderungen eines mutable LegacyRandomAccessIterator erfüllen,
|
(seit C++20) |
-
einen Member-Typ
value_typebesitzen, derTist, und -
einen Member-Typ
referencebesitzen, derT&ist.
- 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()
für
v
aufgerufen wird oder wenn die Lebensdauer von
v
endet, je nachdem, was zuerst eintritt.
Inhaltsverzeichnis |
Parameter
| v | - | ein numerisches Array |
Rückgabewert
Iterator auf einen Wert hinter dem letzten Wert im numerischen Array.
Exceptions
Kann implementierungsdefinierte Ausnahmen auslösen.
Hinweise
Im Gegensatz zu anderen Funktionen, die
std::valarray
Argumente nehmen, kann
end()
die Ersatztypen (wie die von Ausdrucksvorlagen erzeugten Typen) nicht akzeptieren, die von Ausdrücken mit Valarrays zurückgegeben werden können:
std::
end
(
v1
+
v2
)
ist nicht portabel,
std::
end
(
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> int main() { const std::valarray<char> va { 'H', 'e', 'l', 'l', 'o', ',', ' ', 'C', '+', '+', '!', '\n' }; std::for_each(std::begin(va), std::end(va), [](char c){ std::cout << c; }); }
Ausgabe:
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.
end()
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)
|
überlädt
std::begin
(Funktions-Template) |