std::ranges:: uninitialized_fill
|
Определено в заголовке
<memory>
|
||
|
Сигнатура вызова
|
||
|
template
<
no-throw-forward-iterator
I, no
-
throw
-
sentinel
-
for
<
I
>
S,
class
T
>
|
(1) |
(начиная с C++20)
(constexpr начиная с C++26) |
|
template
<
no-throw-forward-range
R,
class
T
>
requires
std::
constructible_from
<
ranges::
range_value_t
<
R
>
,
|
(2) |
(начиная с C++20)
(constexpr начиная с C++26) |
[
first
,
last
)
как если бы
for
(
;
first
!
=
last
;
++
first
)
::
new
(
voidify
(
*
first
)
)
std::
remove_reference_t
<
std::
iter_reference_t
<
I
>>
(
value
)
;
return
first
;
Описываемые на этой странице функциональные сущности являются algorithm function objects (неформально известными как niebloids ), то есть:
- Явные списки аргументов шаблона не могут быть указаны при вызове любого из них.
- Ни один из них не видим для argument-dependent lookup .
- Когда любой из них найден с помощью normal unqualified lookup как имя слева от оператора вызова функции, argument-dependent lookup блокируется.
Содержание |
Параметры
| first, last | - | пара итератор-страж, определяющая диапазон элементов для инициализации |
| r | - |
range
элементов для инициализации
|
| value | - | значение для конструирования элементов |
Возвращаемое значение
Как описано выше.
Сложность
Линейно по размеру неинициализированной области памяти.
Исключения
Любое исключение, выброшенное при конструировании элементов в целевом диапазоне.
Примечания
Реализация может повысить эффективность
ranges::uninitialized_fill
, например, используя
ranges::fill
, если тип значения выходного диапазона является
TrivialType
.
| Feature-test macro | Value | Std | Feature |
|---|---|---|---|
__cpp_lib_raw_memory_algorithms
|
202411L
|
(C++26) | constexpr для специализированных алгоритмов работы с памятью , ( 1,2 ) |
Возможная реализация
struct uninitialized_fill_fn { template<no-throw-forward-iterator I, no-throw-sentinel-for<I> S, class T> requires std::constructible_from<std::iter_value_t<I>, const T&> constexpr I operator()(I first, S last, const T& value) const { I rollback{first}; try { for (; !(first == last); ++first) ranges::construct_at(std::addressof(*first), value); return first; } catch (...) { // откат: уничтожить созданные элементы for (; rollback != first; ++rollback) ranges::destroy_at(std::addressof(*rollback)); throw; } } template<no-throw-forward-range R, class T> requires std::constructible_from<ranges::range_value_t<R>, const T&> constexpr ranges::borrowed_iterator_t<R> operator()(R&& r, const T& value) const { return (*this)(ranges::begin(r), ranges::end(r), value); } }; inline constexpr uninitialized_fill_fn uninitialized_fill{}; |
Пример
#include <iostream> #include <memory> #include <string> int main() { constexpr int n{4}; alignas(alignof(std::string)) char out[n * sizeof(std::string)]; try { auto first{reinterpret_cast<std::string*>(out)}; auto last{first + n}; std::ranges::uninitialized_fill(first, last, "▄▀▄▀▄▀▄▀"); int count{1}; for (auto it{first}; it != last; ++it) std::cout << count++ << ' ' << *it << '\n'; std::ranges::destroy(first, last); } catch(...) { std::cout << "Exception!\n"; } }
Вывод:
1 ▄▀▄▀▄▀▄▀ 2 ▄▀▄▀▄▀▄▀ 3 ▄▀▄▀▄▀▄▀ 4 ▄▀▄▀▄▀▄▀
Отчеты о дефектах
Следующие отчеты об изменениях поведения, влияющие на дефекты, были применены ретроактивно к ранее опубликованным стандартам C++.
| DR | Applied to | Behavior as published | Correct behavior |
|---|---|---|---|
| LWG 3870 | C++20 | этот алгоритм может создавать объекты в const хранилище | оставлено запрещенным |
Смотрите также
|
(C++20)
|
копирует объект в неинициализированную область памяти, определяемую началом и количеством
(функциональный объект алгоритма) |
|
копирует объект в неинициализированную область памяти, определяемую диапазоном
(шаблон функции) |