Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje