CKTIS / C++
std::launder — un puntatore dopo il riutilizzo della memoria
std::launder di <new> restituisce un puntatore a un oggetto a un dato indirizzo quando un vecchio puntatore non fa automaticamente riferimento al suo sostituto. Non crea oggetti e non corregge accessi non validi alla memoria.
Versione: C++23; repository compiler flag, production runtime not attested
Sintassi
#include <new>
// Inside a function, given a T* p that meets std::launder's preconditions:
T* current = std::launder(p);std::launder(p) restituisce un puntatore di tipo T* a un oggetto all'indirizzo rappresentato da p. È utile dopo il riutilizzo della memoria quando le regole sulla durata di vita impediscono di usare il vecchio puntatore come puntatore al nuovo oggetto. È dichiarata in <new>; non alloca memoria né avvia la durata di vita di un oggetto.
T non può essere un tipo funzione né void. A quell'indirizzo deve esistere un oggetto il cui tipo sia simile a T secondo le regole di qualificazione. Nel caso ordinario deve già trovarsi entro la propria durata di vita. Ogni byte raggiungibile tramite il risultato deve essere raggiungibile anche tramite p: la funzione non amplia l'intervallo di accesso consentito. Non corregge un allineamento errato, un tipo incompatibile o l'accesso a memoria deallocata.
Con la sostituzione trasparente, i vecchi puntatori fanno automaticamente riferimento al nuovo oggetto, quindi std::launder non è necessario. L'esempio sostituisce intenzionalmente un oggetto completo const Item nella memoria dinamica, caso in cui tale regola non si applica. Non riutilizzare in modo analogo la memoria di un oggetto completo const con durata di memorizzazione automatica, statica o thread.
Nell'esempio, placement new crea il sostituto e std::launder(old) fornisce il puntatore usato per la lettura e per delete. Valutare direttamente old->value dopo la sostituzione avrebbe comportamento indefinito. In alternativa, si può conservare il puntatore restituito direttamente da placement new invece di chiamare std::launder. L'espressione «barriera di ottimizzazione dei puntatori» non indica una barriera di sincronizzazione tra thread.
Esempi
#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;
}
Risultato
5
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.