std::ranges:: uninitialized_default_construct
|
Определено в заголовке
<memory>
|
||
|
Сигнатура вызова
|
||
|
template
<
no-throw-forward-iterator
I, no
-
throw
-
sentinel
-
for
<
I
>
S
>
requires
std::
default_initializable
<
std::
iter_value_t
<
I
>>
|
(1) |
(начиная с C++20)
(constexpr начиная с C++26) |
|
template
<
no-throw-forward-range
R
>
requires
std::
default_initializable
<
ranges::
range_value_t
<
R
>>
|
(2) |
(начиная с C++20)
(constexpr начиная с C++26) |
[
first
,
last
)
с помощью
default-инициализации
, как если бы:
for
(
;
first
!
=
last
;
++
first
)
::
new
(
voidify
(
*
first
)
)
std::
remove_reference_t
<
std::
iter_reference_t
<
I
>>
;
return
first
;
Функциональные сущности, описанные на этой странице, являются algorithm function objects (неформально известными как niebloids ), то есть:
- Явные списки аргументов шаблона не могут быть указаны при вызове любого из них.
- Ни один из них не видим для argument-dependent lookup .
- Когда любой из них найден с помощью normal unqualified lookup как имя слева от оператора вызова функции, argument-dependent lookup блокируется.
Содержание |
Параметры
| first, last | - | пара итератор-страж, определяющая диапазон элементов для инициализации |
| r | - |
range
элементов для инициализации
|
Возвращаемое значение
Как описано выше.
Сложность
Линейно по расстоянию между first и last .
Исключения
Любое исключение, выброшенное при конструировании элементов в целевом диапазоне.
Примечания
Реализация может пропустить создание объектов (без изменения наблюдаемого эффекта), если при инициализации по умолчанию объекта std:: iter_value_t < I > не вызывается нетривиальный конструктор по умолчанию, что может быть обнаружено с помощью std::is_trivially_default_constructible .
| Макрос тестирования возможностей | Значение | Стандарт | Возможность |
|---|---|---|---|
__cpp_lib_raw_memory_algorithms
|
202411L
|
(C++26) | constexpr для специализированных алгоритмов работы с памятью , ( 1,2 ) |
Возможная реализация
struct uninitialized_default_construct_fn { template<no-throw-forward-iterator I, no-throw-sentinel-for<I> S> requires std::default_initializable<std::iter_value_t<I>> constexpr I operator()(I first, S last) const { using ValueType = std::remove_reference_t<std::iter_reference_t<I>>; if constexpr (std::is_trivially_default_constructible_v<ValueType>) return ranges::next(first, last); // пропустить инициализацию I rollback{first}; try { for (; !(first == last); ++first) ::new (static_cast<void*>(std::addressof(*first))) ValueType; return first; } catch (...) // откат: уничтожить созданные элементы { for (; rollback != first; ++rollback) ranges::destroy_at(std::addressof(*rollback)); throw; } } template<no-throw-forward-range R> requires std::default_initializable<ranges::range_value_t<R>> constexpr ranges::borrowed_iterator_t<R> operator()(R&& r) const { return (*this)(ranges::begin(r), ranges::end(r)); } }; inline constexpr uninitialized_default_construct_fn uninitialized_default_construct{}; |
Пример
#include <cstring> #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{first + n}; std::ranges::uninitialized_default_construct(first, last); 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"; } // Обратите внимание, что для "тривиальных типов" uninitialized_default_construct // обычно не заполняет нулями данную неинициализированную область памяти. constexpr char sample[]{'A', 'B', 'C', 'D', '\n'}; char v[]{'A', 'B', 'C', 'D', '\n'}; std::ranges::uninitialized_default_construct(std::begin(v), std::end(v)); if (std::memcmp(v, sample, sizeof(v)) == 0) { std::cout << " "; // Возможно неопределенное поведение, ожидается разрешение CWG 1997: // for (const char c : v) { std::cout << c << ' '; } for (const char c : sample) std::cout << c << ' '; } else std::cout << "Unspecified\n"; }
Возможный вывод:
1 ▄▀▄▀▄▀▄▀ 2 ▄▀▄▀▄▀▄▀ 3 ▄▀▄▀▄▀▄▀ 4 ▄▀▄▀▄▀▄▀ A B C D
Отчеты о дефектах
Следующие отчеты об изменениях поведения, влияющие на дефекты, были применены ретроактивно к ранее опубликованным стандартам C++.
| DR | Applied to | Behavior as published | Correct behavior |
|---|---|---|---|
| LWG 3870 | C++20 | этот алгоритм может создавать объекты в const хранилище | оставлено запрещенным |
Смотрите также
|
создаёт объекты с помощью
default-initialization
в неинициализированной области памяти, заданной началом и количеством
(объект-функция алгоритма) |
|
|
создаёт объекты с помощью
value-initialization
в неинициализированной области памяти, заданной диапазоном
(объект-функция алгоритма) |
|
|
создаёт объекты с помощью
value-initialization
в неинициализированной области памяти, заданной началом и количеством
(объект-функция алгоритма) |
|
|
(C++17)
|
создаёт объекты с помощью
default-initialization
в неинициализированной области памяти, заданной диапазоном
(шаблон функции) |