std::ranges:: uninitialized_move, std::ranges:: uninitialized_move_result
|
Определено в заголовке
<memory>
|
||
|
Сигнатура вызова
|
||
|
template
<
std::
input_iterator
I,
std::
sentinel_for
<
I
>
S1,
no-throw-forward-iterator
O, no
-
throw
-
sentinel
-
for
<
O
>
S2
>
|
(1) |
(начиная с C++20)
(constexpr начиная с C++26) |
|
template
<
ranges::
input_range
IR,
no-throw-forward-range
OR
>
requires
std::
constructible_from
|
(2) |
(начиная с C++20)
(constexpr начиная с C++26) |
|
Вспомогательные типы
|
||
|
template
<
class
I,
class
O
>
using uninitialized_move_result = ranges:: in_out_result < I, O > ; |
(3) | (начиная с C++20) |
Пусть N будет ranges:: min ( ranges:: distance ( ifirst, ilast ) , ranges:: distance ( ofirst, olast ) ) .
[
ifirst
,
ilast
)
(используя семантику перемещения, если поддерживается) в неинициализированную область памяти
[
ofirst
,
olast
)
следующим образом:
for
(
;
ifirst
!
=
ilast
&&
ofirst
!
=
olast
;
++
ofirst,
(
void
)
++
ifirst
)
::
new
(
voidify
(
*
ofirst
)
)
std::
remove_reference_t
<
std::
iter_reference_t
<
O
>>
(
ranges::
iter_move
(
ifirst
)
)
;
return
{
std
::
move
(
ifirst
)
, ofirst
}
;
[
ofirst
,
olast
)
, уничтожаются в неопределенном порядке. Также объекты в
[
ifirst
,
ilast
)
, которые уже были перемещены, остаются в допустимом, но неопределенном состоянии.
ranges:: begin ( out_range ) , ranges:: end ( out_range ) ) ; .
Описываемые на этой странице функциональные сущности являются algorithm function objects (неформально известными как niebloids ), то есть:
- Явные списки аргументов шаблона не могут быть указаны при вызове любого из них.
- Ни один из них не видим для argument-dependent lookup .
- Когда любой из них найден с помощью normal unqualified lookup как имя слева от оператора вызова функции, argument-dependent lookup блокируется.
Содержание |
Параметры
| ifirst, ilast | - | пара итератор-страж, определяющая входной диапазон элементов для перемещения |
| in_range | - |
входной
range
элементов для перемещения
|
| ofirst, olast | - | пара итератор-страж, определяющая выходной диапазон элементов для инициализации |
| out_range | - |
выходной
range
для инициализации
|
Возвращаемое значение
Как описано выше.
Сложность
Линейно по N .
Исключения
Любое исключение, выброшенное при конструировании элементов в целевом диапазоне.
Примечания
Реализация может повысить эффективность
ranges::uninitialized_move
, например, используя
ranges::copy_n
, если тип значения выходного диапазона является
TrivialType
.
| Feature-test macro | Value | Std | Feature |
|---|---|---|---|
__cpp_lib_raw_memory_algorithms
|
202411L
|
(C++26) | constexpr для специализированных алгоритмов работы с памятью , ( 1,2 ) |
Возможная реализация
struct uninitialized_move_fn { template<std::input_iterator I, std::sentinel_for<I> S1, no-throw-forward-iterator O, no-throw-sentinel-for<O> S2> requires std::constructible_from<std::iter_value_t<O>, std::iter_rvalue_reference_t<I>> constexpr ranges::uninitialized_move_result<I, O> operator()(I ifirst, S1 ilast, O ofirst, S2 olast) const { using ValueType = std::remove_reference_t<std::iter_reference_t<O>>; O current{ofirst}; try { for (; !(ifirst == ilast or current == olast); ++ifirst, ++current) ::new (static_cast<void*>(std::addressof(*current)))) ValueType(ranges::iter_move(ifirst)); return {std::move(ifirst), std::move(current)}; } catch (...) // откат: уничтожить созданные элементы { for (; ofirst != current; ++ofirst) ranges::destroy_at(std::addressof(*ofirst)); throw; } } template<ranges::input_range IR, no-throw-forward-range OR> requires std::constructible_from<ranges::range_value_t<OR>, ranges::range_rvalue_reference_t<IR>> constexpr ranges::uninitialized_move_result<ranges::borrowed_iterator_t<IR>, ranges::borrowed_iterator_t<OR>> operator()(IR&& in_range, OR&& out_range) const { return (*this)(ranges::begin(in_range), ranges::end(in_range), ranges::begin(out_range), ranges::end(out_range)); } }; inline constexpr uninitialized_move_fn uninitialized_move{}; |
Пример
#include <cstdlib> #include <iomanip> #include <iostream> #include <memory> #include <string> void print(auto rem, auto first, auto last) { for (std::cout << rem; first != last; ++first) std::cout << std::quoted(*first) << ' '; std::cout << '\n'; } int main() { std::string in[]{"Home", "World"}; print("initially, in: ", std::begin(in), std::end(in)); if (constexpr auto sz = std::size(in); void* out = std::aligned_alloc(alignof(std::string), sizeof(std::string) * sz)) { try { auto first{static_cast<std::string*>(out)}; auto last{first + sz}; std::ranges::uninitialized_move(std::begin(in), std::end(in), first, last); print("after move, in: ", std::begin(in), std::end(in)); print("after move, out: ", first, last); std::ranges::destroy(first, last); } catch (...) { std::cout << "Exception!\n"; } std::free(out); } }
Возможный вывод:
initially, in: "Home" "World" after move, in: "" "" after move, out: "Home" "World"
Отчеты о дефектах
Следующие отчеты об изменениях поведения, влияющие на дефекты, были применены ретроактивно к ранее опубликованным стандартам C++.
| DR | Applied to | Behavior as published | Correct behavior |
|---|---|---|---|
| LWG 3870 | C++20 | этот алгоритм может создавать объекты в const хранилище | оставлено запрещенным |
Смотрите также
|
(C++20)
|
перемещает заданное количество объектов в неинициализированную область памяти
(функциональный объект алгоритма) |
|
(C++17)
|
перемещает диапазон объектов в неинициализированную область памяти
(шаблон функции) |