CKTIS / C++
std::launder — un pointeur après réutilisation du stockage
std::launder de <new> fournit un pointeur vers un objet situé à une adresse donnée lorsqu'un ancien pointeur ne désigne pas automatiquement son objet de remplacement. Il ne crée pas d'objet et ne corrige pas un accès mémoire invalide.
Version : 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) renvoie un pointeur de type T* vers un objet situé à l'adresse représentée par p. Cette fonction est utile après la réutilisation du stockage lorsque les règles de durée de vie empêchent d'utiliser l'ancien pointeur comme pointeur vers le nouvel objet. Déclarée dans <new>, elle n'alloue pas de stockage et ne démarre pas la durée de vie d'un objet.
T ne doit être ni un type fonction ni void. Un objet dont le type est similaire à T selon les règles de qualification doit exister à cette adresse. Dans le cas ordinaire, il doit déjà être dans sa durée de vie. Chaque octet accessible par le résultat doit aussi être accessible par p : la fonction n'élargit pas la plage d'accès autorisée. Elle ne corrige ni un mauvais alignement, ni un type incompatible, ni l'accès à un stockage désalloué.
En cas de remplacement transparent, les anciens pointeurs désignent automatiquement le nouvel objet ; std::launder est donc inutile. L'exemple remplace délibérément un objet complet const Item dans le stockage dynamique, auquel cette règle ne s'applique pas. Ne réutilisez pas de façon analogue le stockage d'un objet complet const à durée de stockage automatique, statique ou locale à un thread.
Dans l'exemple, placement new crée l'objet de remplacement, et std::launder(old) fournit le pointeur utilisé pour la lecture et delete. Évaluer directement old->value après le remplacement aurait un comportement indéfini. On peut aussi conserver le pointeur renvoyé directement par placement new au lieu d'appeler std::launder. L'expression « barrière d'optimisation des pointeurs » ne désigne pas une barrière de synchronisation entre threads.
Exemples
#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;
}
Résultat
5
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.