CKTIS / C++
std::launder — ein Zeiger nach der Wiederverwendung von Speicher
std::launder aus <new> liefert einen Zeiger auf ein Objekt an einer bestimmten Adresse, wenn ein alter Zeiger nicht automatisch auf dessen Ersatzobjekt verweist. Die Funktion erzeugt kein Objekt und behebt keinen ungültigen Speicherzugriff.
Version: C++23; repository compiler flag, production runtime not attested
Syntax
#include <new>
// Inside a function, given a T* p that meets std::launder's preconditions:
T* current = std::launder(p);std::launder(p) gibt einen Zeiger vom Typ T* auf ein Objekt an der durch p dargestellten Adresse zurück. Es ist nach der Wiederverwendung von Speicher nützlich, wenn die Lebensdauerregeln verhindern, den alten Zeiger als Zeiger auf das neue Objekt zu verwenden. Die Funktion ist in <new> deklariert; sie reserviert weder Speicher noch beginnt sie die Lebensdauer eines Objekts.
T darf weder ein Funktionstyp noch void sein. An dieser Adresse muss ein Objekt existieren, dessen Typ gemäß den Qualifizierungsregeln T ähnlich ist. Im gewöhnlichen Fall muss es sich bereits innerhalb seiner Lebensdauer befinden. Jedes Byte, das über das Ergebnis erreichbar ist, muss auch über p erreichbar sein: Die Funktion erweitert den zulässigen Zugriffsbereich nicht. Sie behebt weder eine falsche Ausrichtung noch einen inkompatiblen Typ oder den Zugriff auf freigegebenen Speicher.
Bei transparenter Ersetzung verweisen alte Zeiger automatisch auf das neue Objekt, sodass std::launder nicht erforderlich ist. Das Beispiel ersetzt absichtlich ein vollständiges const Item im dynamischen Speicher, für das diese Regel nicht gilt. Verwenden Sie den Speicher eines vollständigen const-Objekts mit automatischer, statischer oder Thread-Speicherdauer nicht auf dieselbe Weise erneut.
Im Beispiel erzeugt placement new das Ersatzobjekt, und std::launder(old) liefert den Zeiger, der zum Lesen und für delete verwendet wird. old->value nach dem Ersetzen direkt auszuwerten, hätte undefiniertes Verhalten. Alternativ kann der direkt von placement new zurückgegebene Zeiger aufbewahrt werden, statt std::launder aufzurufen. Die Bezeichnung „Zeiger-Optimierungsbarriere“ bedeutet keine Synchronisationsbarriere für Threads.
Beispiele
#include <iostream>
#include <new>
struct Item {
int value;
};
int main() {
const Item* old = new const Item{3};
::new (static_cast<void*>(const_cast<Item*>(old))) const Item{5};
const Item* current = std::launder(old);
std::cout << current->value << '\n';
delete current;
}
Ergebnis
5
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.