std::destroy_n
Von cppreference.com
| Definiert in Header <memory> |
||
| (1) | ||
template< class ForwardIt, class Size > ForwardIt destroy_n( ForwardIt first, Size n ); |
(seit C++17) (bis C++20) |
|
| template< class ForwardIt, class Size > constexpr ForwardIt destroy_n( ForwardIt first, Size n ); |
(seit C++20) | |
| template< class ExecutionPolicy, class ForwardIt, class Size > ForwardIt destroy_n( ExecutionPolicy&& policy, ForwardIt first, Size n ); |
(2) | (seit C++17) |
1) Zerstört die n Objekte im Bereich beginnend bei first, als ob durch
for (; n > 0; (void) ++first, --n) std::destroy_at(std::addressof(*first));
2) Dasselbe wie (1), aber ausgeführt gemäß policy. Dieser Überladungsparameter zur Überladungsauflösung nur, wenn alle folgenden Bedingungen erfüllt sind
|
std::is_execution_policy_v<std::decay_t<ExecutionPolicy>> ist true. |
(bis C++20) |
|
std::is_execution_policy_v<std::remove_cvref_t<ExecutionPolicy>> ist true. |
(seit C++20) |
Inhalt |
[bearbeiten] Parameter
| first | - | der Anfang des zu zerstörenden Elemente-Bereichs |
| n | - | die Anzahl der zu zerstörenden Elemente |
| policy | - | die Ausführungsrichtlinie, die verwendet werden soll |
| Typanforderungen | ||
-ForwardIt muss die Anforderungen von LegacyForwardIterator erfüllen. | ||
-Keine Inkrementierung, Zuweisung, Vergleich oder Indirektion durch gültige Instanzen von ForwardIt dürfen Ausnahmen auslösen. | ||
[bearbeiten] Rückgabewert
Das Ende des zerstörten Objektbereichs (d. h. std::next(first, n)).
[bearbeiten] Komplexität
Linear in n.
[bearbeiten] Ausnahmen
Die Überladung mit einem Template-Parameter namens ExecutionPolicy meldet Fehler wie folgt
- Wenn die Ausführung einer Funktion, die als Teil des Algorithmus aufgerufen wird, eine Ausnahme auslöst und
ExecutionPolicyeine der Standardrichtlinien ist, wird std::terminate aufgerufen. Für jede andereExecutionPolicyist das Verhalten implementierungsabhängig. - Wenn dem Algorithmus der Speicher zur Neuzuweisung fehlt, wird std::bad_alloc ausgelöst.
[bearbeiten] Mögliche Implementierung
template<class ForwardIt, class Size> constexpr // since C++20 ForwardIt destroy_n(ForwardIt first, Size n) { for (; n > 0; (void) ++first, --n) std::destroy_at(std::addressof(*first)); return first; } |
[bearbeiten] Beispiel
Das folgende Beispiel zeigt, wie destroy_n verwendet wird, um eine zusammenhängende Sequenz von Elementen zu zerstören.
Führen Sie diesen Code aus
#include <iostream> #include <memory> #include <new> struct Tracer { int value; ~Tracer() { std::cout << value << " destructed\n"; } }; int main() { alignas(Tracer) unsigned char buffer[sizeof(Tracer) * 8]; for (int i = 0; i < 8; ++i) new(buffer + sizeof(Tracer) * i) Tracer{i}; //manually construct objects auto ptr = std::launder(reinterpret_cast<Tracer*>(buffer)); std::destroy_n(ptr, 8); }
Ausgabe
0 destructed 1 destructed 2 destructed 3 destructed 4 destructed 5 destructed 6 destructed 7 destructed
[bearbeiten] Siehe auch
| (C++17) |
zerstört einen Bereich von Objekten (Funktions-Template) |
| (C++17) |
zerstört ein Objekt an einer gegebenen Adresse (Funktions-Template) |
| (C++20) |
zerstört eine Anzahl von Objekten in einem Bereich (Algorithmus-Funktionsobjekt) |
