KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::launder — een pointer na hergebruik van opslag

std::launder uit <new> levert een pointer op naar een object op een bepaald adres wanneer een oude pointer niet automatisch naar het vervangende object verwijst. De functie maakt geen object aan en herstelt geen ongeldige geheugentoegang.

Versie: 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) retourneert een pointer van het type T* naar een object op het adres dat door p wordt weergegeven. De functie is nuttig na hergebruik van opslag wanneer de levensduurregels verhinderen dat de oude pointer als pointer naar het nieuwe object wordt gebruikt. Ze is gedeclareerd in <new>; ze alloceert geen opslag en start de levensduur van een object niet.

T mag geen functietype of void zijn. Op dat adres moet een object bestaan waarvan het type volgens de kwalificatieregels vergelijkbaar is met T. In het gewone geval moet het object zich al binnen zijn levensduur bevinden. Elke byte die via het resultaat bereikbaar is, moet ook via p bereikbaar zijn: de functie vergroot het toegestane toegangsbereik niet. Ze herstelt geen onjuiste uitlijning, incompatibel type of toegang tot vrijgegeven opslag.

Bij transparante vervanging verwijzen oude pointers automatisch naar het nieuwe object, dus std::launder is overbodig. Het voorbeeld vervangt bewust een volledig const Item-object in dynamische opslag, waarop die regel niet van toepassing is. Hergebruik de opslag van een volledig const-object met automatische, statische of thread-opslagduur niet op vergelijkbare wijze.

In het voorbeeld maakt placement new het vervangende object, en levert std::launder(old) de pointer voor lezen en delete. old->value na de vervanging rechtstreeks evalueren zou ongedefinieerd gedrag hebben. Je kunt ook de pointer bewaren die placement new rechtstreeks retourneert, in plaats van std::launder aan te roepen. De naam ‘pointer-optimalisatiebarrière’ betekent geen synchronisatiebarrière voor threads.

Voorbeelden

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

Resultaat

5

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen