Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje