Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C++

std::launder — un puntero tras reutilizar el almacenamiento

std::launder de <new> obtiene un puntero a un objeto situado en una dirección dada cuando un puntero antiguo no hace referencia automáticamente a su sustituto. No crea objetos ni corrige accesos inválidos a memoria.

Versión: C++23; repository compiler flag, production runtime not attested

Sintaxis

#include <new>

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

std::launder(p) devuelve un puntero de tipo T* a un objeto situado en la dirección representada por p. Resulta útil tras reutilizar almacenamiento cuando las reglas de duración de vida impiden usar el puntero antiguo como puntero al objeto nuevo. Está declarada en <new>; no asigna almacenamiento ni inicia la duración de vida de un objeto.

T no puede ser un tipo de función ni void. En esa dirección debe existir un objeto cuyo tipo sea similar a T según las reglas de cualificación. En el caso habitual, ya debe encontrarse dentro de su duración de vida. Todos los bytes accesibles a través del resultado también deben ser accesibles a través de p: la función no amplía el intervalo de acceso permitido. No corrige una alineación incorrecta, un tipo incompatible ni el acceso a almacenamiento liberado.

Con la sustitución transparente, los punteros antiguos hacen referencia automáticamente al objeto nuevo, por lo que std::launder no hace falta. El ejemplo sustituye deliberadamente un objeto completo const Item en almacenamiento dinámico, donde esa regla no se aplica. No reutilices de forma análoga el almacenamiento de un objeto completo const con duración de almacenamiento automática, estática o de hilo.

En el ejemplo, placement new crea el sustituto y std::launder(old) proporciona el puntero usado para leer y para delete. Evaluar directamente old->value después de la sustitución tendría comportamiento indefinido. También se puede conservar el puntero devuelto directamente por placement new en lugar de llamar a std::launder. La expresión «barrera de optimización de punteros» no significa una barrera de sincronización entre hilos.

Ejemplos

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

Resultado

5

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes