Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::launder — wskaźnik po ponownym użyciu pamięci

std::launder z nagłówka <new> pozwala uzyskać wskaźnik do obiektu istniejącego pod danym adresem, gdy stary wskaźnik nie odnosi się automatycznie do jego następcy. Nie tworzy obiektu ani nie naprawia nieprawidłowego dostępu do pamięci.

Wersja: C++23; repository compiler flag, production runtime not attested

Składnia

#include <new>

// Inside a function, given a T* p that meets std::launder's preconditions:
T* current = std::launder(p);

std::launder(p) zwraca wskaźnik typu T* do obiektu pod adresem reprezentowanym przez p. Jest przydatne po ponownym użyciu pamięci, gdy reguły czasu życia nie pozwalają używać starego wskaźnika jako wskaźnika do nowego obiektu. Funkcja jest zadeklarowana w <new>; nie alokuje pamięci ani nie rozpoczyna czasu życia obiektu.

T nie może być typem funkcji ani void. Pod wskazanym adresem musi istnieć obiekt o typie podobnym do T w rozumieniu reguł kwalifikatorów. W zwykłym przypadku musi on już znajdować się w swoim czasie życia. Wszystkie bajty osiągalne przez wynik muszą być osiągalne także przez p: funkcja nie rozszerza dozwolonego zakresu dostępu. Nie naprawia błędnego wyrównania, niezgodnego typu ani dostępu do zwolnionej pamięci.

Przy przezroczystym zastąpieniu obiektu stare wskaźniki automatycznie odnoszą się do nowego obiektu, więc std::launder jest zbędne. Przykład celowo zastępuje kompletny obiekt const Item w pamięci dynamicznej, dla którego ta reguła nie działa. Nie wolno analogicznie wykorzystywać pamięci kompletnego obiektu const o automatycznym, statycznym lub wątkowym okresie przechowywania.

W przykładzie placement new tworzy następcę, a std::launder(old) daje wskaźnik używany do odczytu i delete. Samo old->value po zastąpieniu miałoby niezdefiniowane zachowanie. Można też zachować wskaźnik zwrócony bezpośrednio przez placement new, zamiast wywoływać std::launder. Oznaczenie „bariera optymalizacji wskaźnika” nie oznacza bariery synchronizacji wątków.

Przykłady

#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;
}

Wynik

5

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła