std::construct_at
| Определено в заголовке <memory>
|
||
template< class T, class... Args >
constexpr T* construct_at( T* location, Args&&... args );
|
(начиная с C++20) | |
Создаёт T объект, инициализированный аргументами из args по заданному адресу location.
Эквивалентно
if constexpr (std::is_array_v<T>)
return ::new (voidify (*location)) T[1]();
else
return ::new (voidify (*location)) T(std::forward<Args>(args)...);
, за исключением того, что construct_at может использоваться при вычислении константных выражений(до C++26).
Когда construct_at вызывается при вычислении некоторого константного выражения expr, location должен указывать либо на хранилище, полученное с помощью std::allocator<T>::allocate, либо на объект, время жизни которого началось в пределах вычисления expr.
Эта перегрузка участвует в разрешении перегрузки только если выполняются все следующие условия:
std::is_unbounded_array_v<T>являетсяfalse.::new(std::declval<void*>()) T(std::declval<Args>()...)является корректно сформированным при рассмотрении как невычисляемый операнд.
Если std::is_array_v<T> является true и sizeof...(Args) не равно нулю, программа считается ошибочной.
Параметры
| location | - |
указатель на неинициализированную область памяти, в которой будет сконструирован объект типа
T
|
| args... | - | аргументы, используемые для инициализации |
Возвращаемое значение
location
Пример
#include <bit> #include <memory> class S { int x_; float y_; double z_; public: constexpr S(int x, float y, double z) : x_{x}, y_{y}, z_{z} {} [[nodiscard("no side-effects!")]] constexpr bool operator==(const S&) const noexcept = default; }; consteval bool test() { alignas(S) unsigned char storage[sizeof(S)]{}; S uninitialized = std::bit_cast<S>(storage); std::destroy_at(&uninitialized); S* ptr = std::construct_at(std::addressof(uninitialized), 42, 2.71f, 3.14); const bool res{*ptr == S{42, 2.71f, 3.14}}; std::destroy_at(ptr); return res; } static_assert(test()); int main() {}
Сообщения о дефектах
Следующие сообщения о дефектах, изменяющих поведение, были применены ретроактивно к ранее опубликованным стандартам C++.
| DR | Применён к | Поведение в опубликованной версии | Корректное поведение |
|---|---|---|---|
| LWG 3436 | C++20 | construct_at не мог создавать объекты типов массивов
|
может инициализировать значениями ограниченные массивы |
Смотрите также
|
выделяет неинициализированную память
(публичная функция-член
std::allocator<T>
)
|
|
|
[static]
|
создает объект в выделенной памяти
(шаблон функции) |
|
(C++17)
|
уничтожает объект по заданному адресу
(шаблон функции) |
|
(C++20)
|
создает объект по заданному адресу
(функциональный объект алгоритма) |