Namespaces
Variants

std::construct_at

From ru.cppreference.net
 
 
Библиотека алгоритмов
Ограниченные алгоритмы и алгоритмы над диапазонами (C++20)
Ограниченные алгоритмы, например, ranges::copy, ranges::sort, ...
Немодифицирующие операции с последовательностями    
Пакетные операции
(C++17)
Операции поиска
Модифицирующие операции с последовательностями
Операции копирования
(C++11)
(C++11)
Операции обмена
Операции преобразования
Операции генерации
Операции удаления
Операции изменения порядка
(до C++17)(C++11)
(C++20)(C++20)
Операции выборки
(C++17)

Сортировка и связанные операции
Операции разделения
(C++11)    

Операции сортировки
Операции двоичного поиска
(на разделенных диапазонах)
Операции над множествами (на отсортированных диапазонах)
Операции слияния (на отсортированных диапазонах)
Операции с кучей
Операции минимума/максимума
(C++11)
(C++17)
Операции лексикографического сравнения
Операции перестановки


Политики выполнения (C++17)
(только для объяснения*)(C++26)

Числовые операции
(C++11)
(C++17)
(C++17)    

Специализированные <memory> алгоритмы

Специализированные <random> алгоритмы
Библиотека C









 
Специализированные <memory> алгоритмы
 
Определено в заголовке <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)
уничтожает объект по заданному адресу
(шаблон функции)
создает объект по заданному адресу
(функциональный объект алгоритма)