CKTIS / C++
std::launder — ukazatel po opětovném použití úložiště
std::launder z <new> získá ukazatel na objekt na dané adrese, pokud starý ukazatel automaticky neodkazuje na jeho náhradu. Nevytváří objekt ani neopravuje neplatný přístup do paměti.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <new>
// Inside a function, given a T* p that meets std::launder's preconditions:
T* current = std::launder(p);std::launder(p) vrací ukazatel typu T* na objekt na adrese reprezentované ukazatelem p. Hodí se po opětovném použití úložiště, pokud pravidla životnosti brání použít starý ukazatel jako ukazatel na nový objekt. Je deklarována v <new>; nealokuje úložiště ani nezahajuje životnost objektu.
T nesmí být funkční typ ani void. Na dané adrese musí existovat objekt, jehož typ je podle pravidel kvalifikátorů podobný typu T. V běžném případě už musí být v době své životnosti. Každý bajt dosažitelný přes výsledek musí být dosažitelný také přes p: funkce nerozšiřuje povolený rozsah přístupu. Neopraví nesprávné zarovnání, nekompatibilní typ ani přístup k uvolněnému úložišti.
Při transparentní náhradě staré ukazatele automaticky odkazují na nový objekt, takže std::launder není potřeba. Příklad záměrně nahrazuje úplný objekt const Item v dynamickém úložišti, na který se toto pravidlo nevztahuje. Obdobně znovu nepoužívejte úložiště úplného objektu const s automatickou, statickou ani vláknovou dobou uložení.
V příkladu vytvoří placement new náhradní objekt a std::launder(old) poskytne ukazatel použitý ke čtení a pro delete. Přímé vyhodnocení old->value po nahrazení by mělo nedefinované chování. Místo volání std::launder lze také uchovat ukazatel vrácený přímo operátorem placement new. Označení „bariéra optimalizace ukazatelů“ neznamená synchronizační bariéru vláken.
Příklady
#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;
}
Výsledek
5
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.