◐ Shell
clean mode source ↗

std::construct_at - cppreference.com

De cppreference.com

Definido en el archivo de encabezado <memory>

template<class T, class... Args> constexpr T* construct_at( T* p, Args&&... args );

(desde C++20)

Crea un objeto T inicializado con los argumentos args... en la dirección p dada. La especialización de esta plantilla de función participa en la resolución de sobrecarga solo si ::new(std::declval<void*>()) T(std::declval<Args>()...) está fien formada en un contexto no evaluado.

Equivalente a

return ::new (const_cast<void*>(static_cast<const volatile void*>(p)))
    T(std::forward<Args>(args)...);

excepto que construct_at puede usarse en la evaluación de expresiones constantes.

Cuando construct_at se llama en la evaluación de alguna expresión constante e, el argumento p debe apuntar o bien a almacenamiento obtenido mediante std::allocator<T>::allocate o a un objeto cuyo tiempo de vida empezó dentro de la evaluación de e.

Parámetros

p - Un puntero al almacenamiento sin inicializar en el cual se construirá un objeto T.
args... - Argumentos usados para la inicialización.

Valor de retorno

p

Ejemplo

#include <iostream>
#include <memory>

struct S {
    int x;
    float y;
    double z;

    S(int x, float y, double z) : x{x}, y{y}, z{z} { std::cout << "S::S();\n"; }
    
    ~S() { std::cout << "S::~S();\n"; }

    void print() const {
        std::cout << "S { x=" << x << "; y=" << y << "; z=" << z << "; };\n";
    }
};

int main()
{
    alignas(S) unsigned char storage[sizeof(S)];

    S* ptr = std::construct_at(reinterpret_cast<S*>(storage), 42, 2.71828f, 3.1415);
    ptr->print();

    std::destroy_at(ptr);
}

Salida:

S::S();
S { x=42; y=2.71828; z=3.1415; };
S::~S();

Véase también

Asigna almacenamiento no inicializado.
(función miembro pública de std::allocator) [editar]

construye un objeto en el almacenamiento asignado

Original:

constructs an object in the allocated storage

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.


(plantilla de función) [editar]
Destruye un objeto en una dirección dada.
(plantilla de función) [editar]
Crea un objeto en una dirección dada
(niebloid) [editar]