std::uninitialized_default_construct_n
С ru.cppreference.net
| Определён в заголовке <memory>
|
||
template< class NoThrowForwardIt, class Size >
NoThrowForwardIt uninitialized_default_construct_n
( NoThrowForwardIt first, Size count );
|
(1) | (начиная с C++17) (constexpr начиная с C++26) |
template< class ExecutionPolicy, class NoThrowForwardIt, class Size >
NoThrowForwardIt uninitialized_default_construct_n
( ExecutionPolicy&& policy, NoThrowForwardIt first, Size count );
|
(2) | (начиная с C++17) |
1) Конструирует элементы в целевой диапазон
first + [0, count) с помощью инициализации по умолчанию как если бы
for (; count > 0; (void)++first, --count)
::new (voidify(*first))
typename std::iterator_traits<NoThrowForwardIt>::value_type;
return first;
Если во время инициализации выбрасывается исключение, уже сконструированные объекты уничтожаются в неопределённом порядке.
2) То же, что и (1), но выполняется согласно
policy. Этот перегруженный вариант участвует в разрешении перегрузки только если значение следующего выражения равно
true:
|
|
(до C++20) |
|
|
(начиная с C++20) |
Параметры
| first | - | начало диапазона элементов для инициализации |
| count | - | количество элементов для конструирования |
| policy | - | используемая политика выполнения |
| Требования к типам | ||
-
NoThrowForwardIt
должен удовлетворять требованиям
LegacyForwardIterator
.
|
||
-
NoThrowForwardIt
не должны генерировать исключения.
|
||
Возвращаемое значение
Как описано выше.
Исключения
2) Во время выполнения:
- Если временные ресурсы памяти, необходимые для распараллеливания, недоступны, std::bad_alloc выбрасывается.
- Если необработанное исключение выбрасывается при доступе к объектам через аргумент алгоритма, поведение определяется политикой выполнения (для стандартных политик, std::terminate вызывается).
Примечания
| Проверка возможности макрос | Значение | Стандарт | Возможность |
|---|---|---|---|
__cpp_lib_raw_memory_algorithms |
202411L |
(C++26) | constexpr для специализированных <memory> алгоритмов, (1)
|
Возможная реализация
template<class NoThrowForwardIt, class Size> constexpr ForwardIt uninitialized_default_construct_n(NoThrowForwardIt first, Size count) { using T = typename std::iterator_traits<NoThrowForwardIt>::value_type; NoThrowForwardIt current = first; try { for (; countn > 0; (void) ++current, --count) ::new (static_cast<void*>(std::addressof(*current))) T; return current; } catch (...) { std::destroy(first, current); throw; } } |
` и `` оставлен без изменений, как и требовалось. HTML-теги и атрибуты также сохранены в оригинальном виде.
Пример
Запустить этот код
#include <cstring> #include <iostream> #include <memory> #include <string> struct S { std::string m{"default value"}; }; int main() { constexpr int n{3}; alignas(alignof(S)) unsigned char mem[n * sizeof(S)]; try { auto first{reinterpret_cast<S*>(mem)}; auto last = std::uninitialized_default_construct_n(first, n); for (auto it{first}; it != last; ++it) std::cout << it->m << '\n'; std::destroy(first, last); } catch(...) { std::cout << "Exception!\n"; } // Для скалярных типов uninitialized_default_construct_n // обычно не выполняет инициализацию нулями данной неинициализированной области памяти. int v[]{1, 2, 3, 4}; const int original[]{1, 2, 3, 4}; std::uninitialized_default_construct_n(std::begin(v), std::size(v)); // Попытка доступа к v может быть неопределенным поведением, // до разрешения CWG 1997: // for (const int i : v) // std::cout << i << ' '; // Результат не определен: std::cout << (std::memcmp(v, original, sizeof(v)) == 0 ? "un" : "") << "modified\n"; }
Возможный вывод:
default value default value default value unmodified
Смотрите также
|
(C++17)
|
конструирует объекты с помощью
default-initialization
в неинициализированной области памяти, определяемой диапазоном
(шаблон функции) |
|
(C++17)
|
конструирует объекты с помощью
value-initialization
в неинициализированной области памяти, определяемой началом и количеством
(шаблон функции) |
|
конструирует объекты с помощью
default-initialization
в неинициализированной области памяти, определяемой началом и количеством
(функциональный объект алгоритма) |