CKTIS / C++
std::launder — ukazovateľ po opätovnom použití úložiska
std::launder z <new> získa ukazovateľ na objekt na danej adrese, ak starý ukazovateľ automaticky neodkazuje na jeho náhradu. Nevytvára objekt ani neopravuje neplatný prístup do pamäte.
Verzia: 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) vracia ukazovateľ typu T* na objekt na adrese reprezentovanej ukazovateľom p. Je užitočná po opätovnom použití úložiska, ak pravidlá životnosti bránia použiť starý ukazovateľ ako ukazovateľ na nový objekt. Je deklarovaná v <new>; nealokuje úložisko ani nezačína životnosť objektu.
T nesmie byť funkčný typ ani void. Na danej adrese musí existovať objekt, ktorého typ je podľa pravidiel kvalifikátorov podobný typu T. V bežnom prípade už musí byť v čase svojej životnosti. Každý bajt dosiahnuteľný cez výsledok musí byť dosiahnuteľný aj cez p: funkcia nerozširuje povolený rozsah prístupu. Neopraví nesprávne zarovnanie, nekompatibilný typ ani prístup k uvoľnenému úložisku.
Pri transparentnej náhrade staré ukazovatele automaticky odkazujú na nový objekt, takže std::launder netreba. Príklad zámerne nahrádza úplný objekt const Item v dynamickom úložisku, na ktorý sa toto pravidlo nevzťahuje. Podobne znovu nepoužívajte úložisko úplného objektu const s automatickou, statickou ani vláknovou dobou uloženia.
V príklade vytvorí placement new náhradný objekt a std::launder(old) poskytne ukazovateľ použitý na čítanie a pre delete. Priame vyhodnotenie old->value po nahradení by malo nedefinované správanie. Namiesto volania std::launder možno uchovať ukazovateľ vrátený priamo operátorom placement new. Označenie „bariéra optimalizácie ukazovateľov“ neznamená synchronizačnú bariéru vlákien.
Prí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ýsledok
5
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.