База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C++

std::launder — указател след повторно използване на памет

std::launder от <new> получава указател към обект на даден адрес, когато стар указател не сочи автоматично към обекта заместител. Тя не създава обект и не поправя невалиден достъп до памет.

Версия: C++23; repository compiler flag, production runtime not attested

Синтаксис

#include <new>

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

std::launder(p) връща указател от тип T* към обект на адреса, представен от p. Полезна е след повторно използване на памет, когато правилата за времето на живот не позволяват старият указател да се използва като указател към новия обект. Декларирана е в <new>; не заделя памет и не започва времето на живот на обект.

T не може да бъде функционален тип или void. На този адрес трябва да съществува обект, чийто тип според правилата за квалификаторите е подобен на T. В обичайния случай той вече трябва да е в рамките на времето си на живот. Всеки байт, достъпен чрез резултата, трябва да е достъпен и чрез p: функцията не разширява разрешения диапазон за достъп. Тя не поправя неправилно подравняване, несъвместим тип или достъп до освободена памет.

При прозрачно заместване старите указатели автоматично сочат към новия обект, така че std::launder не е необходима. Примерът умишлено заменя цял обект const Item в динамична памет, за който това правило не важи. Не използвайте по аналогичен начин повторно паметта на цял обект const с автоматично, статично или нишково време на съхранение.

В примера placement new създава заместващия обект, а std::launder(old) предоставя указателя, използван за четене и за delete. Директното изчисляване на old->value след заместването би имало недефинирано поведение. Вместо това може да запазите указателя, върнат директно от placement new, без да извиквате std::launder. Наименованието „бариера за оптимизация на указатели“ не означава бариера за синхронизация между нишки.

Примери

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

Резултат

5

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници