std::uninitialized_value_construct
Материал из cppreference.com
Определено в заголовочном файле <memory>
|
||
template< class ForwardIt > void uninitialized_value_construct( ForwardIt first, ForwardIt last ); |
(1) | (начиная с C++17) |
template< class ExecutionPolicy, class ForwardIt > void uninitialized_value_construct( ExecutionPolicy&& policy, |
(2) | (начиная с C++17) |
1) Создаёт объекты типа typename iterator_traits<ForwardIt>::value_type в неинициализированной памяти, определяемой диапазоном
::new (static_cast<void*>(std::addressof(*first)))
typename std::iterator_traits<ForwardIt>::value_type();
[
first,
last)
, инициализацией значением, как если бы
for (; first != last; ++first)::new (static_cast<void*>(std::addressof(*first)))
typename std::iterator_traits<ForwardIt>::value_type();
Если во время инициализации возникает исключение, уже созданные объекты уничтожаются в неопределённом порядке.
2) То же, что и (1), но выполняется в соответствии с policy. Эта перегрузка не участвует в разрешении перегрузки, если только
std::is_execution_policy_v<std::decay_t<ExecutionPolicy>> не равно true. |
(до C++20) |
std::is_execution_policy_v<std::remove_cvref_t<ExecutionPolicy>> не равно true. |
(начиная с C++20) |
Содержание |
[править] Параметры
first, last | — | диапазон элементов для инициализации |
policy | — | используемая политика выполнения. Подробнее смотрите политика выполнения. |
Требования к типам | ||
-ForwardIt должен соответствовать требованиям LegacyForwardIterator.
| ||
-Никакое инкрементирование, присваивание, сравнение или косвенное обращение через действительные экземпляры ForwardIt не могут вызывать исключения.
|
[править] Возвращаемое значение
(нет)
[править] Сложность
Линейная по расстоянию между first и last.
[править] Исключения
Перегрузка с параметром шаблона по имени ExecutionPolicy
сообщает об ошибках следующим образом:
- Если выполнение функции, вызванной как часть алгоритма, вызывает исключение и
ExecutionPolicy
является одной из стандартных политик, вызывается std::terminate. Для любой другойExecutionPolicy
поведение определяется реализацией. - Если алгоритму не удаётся выделить память, генерируется std::bad_alloc.
[править] Возможная реализация
template<class ForwardIt> void uninitialized_value_construct(ForwardIt first, ForwardIt last) { using Value = typename std::iterator_traits<ForwardIt>::value_type; ForwardIt current = first; try { for (; current != last; ++current) ::new (const_cast<void*>(static_cast<const volatile void*>( std::addressof(*current)))) Value(); } catch (...) { std::destroy(first, current); throw; } } |
[править] Пример
Запустить этот код
#include <iostream> #include <memory> #include <string> int main() { struct S { std::string m{"Значение по умолчанию"}; }; constexpr int n{3}; alignas(alignof(S)) unsigned char mem[n * sizeof(S)]; try { auto first{reinterpret_cast<S*>(mem)}; auto last{first + n}; std::uninitialized_value_construct(first, last); for (auto it{first}; it != last; ++it) std::cout << it->m << '\n'; std::destroy(first, last); } catch (...) { std::cout << "Исключение!\n"; } // Обратите внимание, что для "тривиальных типов" uninitialized_value_construct // заполняет нулями заданную неинициализированную область памяти. int v[]{1, 2, 3, 4}; for (const int i : v) std::cout << i << ' '; std::cout << '\n'; std::uninitialized_value_construct(std::begin(v), std::end(v)); for (const int i : v) std::cout << i << ' '; std::cout << '\n'; }
Вывод:
Значение по умолчанию Значение по умолчанию Значение по умолчанию 1 2 3 4 0 0 0 0
[править] Отчёты о дефектах
Следующие изменения поведения были применены с обратной силой к ранее опубликованным стандартам C++:
Номер | Применён | Поведение в стандарте | Корректное поведение |
---|---|---|---|
LWG 3870 | C++20 | этот алгоритм может создавать объекты в const хранилище | запрещено |
[править] Смотрите также
создаёт объекты инициализацией значением в неинициализированной области памяти, определяемой началом и количеством (шаблон функции) | |
создаёт объекты инициализацией по умолчанию в неинициализированной области памяти, определяемой диапазоном (шаблон функции) | |
создаёт объекты инициализацией значением в неинициализированной области памяти, определяемой диапазоном (ниблоид) |