std::ranges::uninitialized_value_construct_n
| Определено в заголовке <memory>
|
||
| Сигнатура вызова |
||
template< /*nothrow-forward-iterator*/ I >
requires std::default_initializable<std::iter_value_t<I>>
I uninitialized_value_construct_n( I first,
std::iter_difference_t<I> count );
|
(1) | (начиная с C++20) (constexpr начиная с C++26) |
template< /*execution-policy*/ Ep, /*nothrow-random-access-iterator*/ I >
requires std::default_initializable<std::iter_value_t<I>>
I uninitialized_value_construct_n( Ep&& policy, I first,
std::iter_difference_t<I> count );
|
(2) | (начиная с C++26) |
Для определения /*execution-policy*/см. эту страницу; для определения других концепций, предназначенных только для демонстрации, см. эту страницу.
first + [0, count) путём инициализации значением как если бы
return ranges::uninitialized_value_construct(std::counted_iterator(first, count),
std::default_sentinel).base();
policy.Описанные на этой странице сущности, подобные функциям, являются объектами алгоритмических функций (неформально известными как niebloids), то есть:
- При вызове любой из них нельзя указать явные списки аргументов шаблона.
- Ни одна из них не видна при поиске, зависящем от аргументов.
- Когда любая из них находится с помощью обычного неквалифицированного поиска как имя слева от оператора вызова функции, поиск, зависящий от аргументов, подавляется.
Параметры
| first | - | начало диапазона элементов для инициализации |
| count | - | количество элементов для конструирования |
| policy | - | политика выполнения для использования |
Возвращаемое значение
Как описано выше.
Исключения
Любое исключение, выброшенное при конструировании элементов в диапазоне назначения.
- Если временные ресурсы памяти, необходимые для распараллеливания, недоступны, std::bad_alloc выбрасывается.
- Если необработанное исключение выбрасывается при доступе к объектам через аргумент алгоритма, поведение определяется политикой выполнения (для стандартных политик, вызывается std::terminate).
Примечания
Реализация может повысить эффективность ranges::uninitialized_value_construct_n (используя, например, ranges::fill_n) если тип значения диапазона является CopyAssignable TrivialType.
| Проверка поддержки макрос | Значение | Стандарт | Возможность |
|---|---|---|---|
__cpp_lib_parallel_algorithm |
202506L |
(C++26) | Параллельные алгоритмы диапазонов |
__cpp_lib_raw_memory_algorithms |
202411L |
(C++26) | constexpr для специализированные <memory> алгоритмы, (1)
|
Возможная реализация
struct uninitialized_value_construct_n_fn
{
template</*nothrow-forward-iterator*/ I>
requires std::default_initializable<std::iter_value_t<I>>
constexpr I operator()(I first, std::iter_difference_t<I> count) const
{
auto iter = std::counted_iterator(first, count);
return ranges::uninitialized_value_construct(iter, std::default_sentinel).base();
}
};
inline constexpr uninitialized_value_construct_n_fn uninitialized_value_construct_n{};
|
Пример
#include <iostream> #include <memory> #include <string> int main() { struct S { std::string m{"█▓▒░ █▓▒░ █▓▒░ "}; }; constexpr int n{4}; alignas(alignof(S)) char out[n * sizeof(S)]; try { auto first{reinterpret_cast<S*>(out)}; auto last = std::ranges::uninitialized_value_construct_n(first, n); auto count{1}; for (auto it{first}; it != last; ++it) std::cout << count++ << ' ' << it->m << '\n'; std::ranges::destroy(first, last); } catch (...) { std::cout << "Exception!\n"; } // For scalar types, uninitialized_value_construct_n // zero-initializes the given uninitialized memory area. int v[]{1, 2, 3, 4, 5, 6, 7, 8}; std::cout << ' '; for (const int i : v) std::cout << i << ' '; std::cout << "\n "; std::ranges::uninitialized_value_construct_n(std::begin(v), std::size(v)); for (const int i : v) std::cout << i << ' '; std::cout << '\n'; }
Вывод:
1 █▓▒░ █▓▒░ █▓▒░ 2 █▓▒░ █▓▒░ █▓▒░ 3 █▓▒░ █▓▒░ █▓▒░ 4 █▓▒░ █▓▒░ █▓▒░ 1 2 3 4 5 6 7 8 0 0 0 0 0 0 0 0
См. также
| конструирует объекты путём инициализации значением в неинициализированной области памяти, определяемой диапазоном (функциональный объект алгоритма) | |
| конструирует объекты путём инициализации по умолчанию в неинициализированной области памяти, определяемой диапазоном (функциональный объект алгоритма) | |
| конструирует объекты путём инициализации по умолчанию в неинициализированной области памяти, определяемой началом и количеством (функциональный объект алгоритма) | |
| конструирует объекты путём инициализации значением в неинициализированной области памяти, определяемой началом и количеством (шаблон функции) |