Namespaces
Variants

std::ranges:: uninitialized_move, std::ranges:: uninitialized_move_result

From cppreference.net
Memory management library
( exposition only* )
Allocators
Uninitialized memory algorithms
Constrained uninitialized memory algorithms
Memory resources
Uninitialized storage (until C++20)
( until C++20* )
( until C++20* )
( until C++20* )

Garbage collector support (until C++23)
(C++11) (until C++23)
(C++11) (until C++23)
(C++11) (until C++23)
(C++11) (until C++23)
(C++11) (until C++23)
(C++11) (until C++23)
Определено в заголовке <memory>
Сигнатура вызова
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 >>
uninitialized_move_result < I, O >

uninitialized_move ( I ifirst, S1 ilast, O ofirst, S2 olast ) ;
(1) (начиная с C++20)
(constexpr начиная с C++26)
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 >>
uninitialized_move_result < ranges:: borrowed_iterator_t < IR > ,
ranges:: borrowed_iterator_t < OR >>

uninitialized_move ( IR && in_range, OR && out_range ) ;
(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 ) ) .

1) Копирует N элементов из диапазона [ 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 ) , которые уже были перемещены, остаются в допустимом, но неопределенном состоянии.
2) Эквивалентно return ranges :: uninitialized_move ( ranges:: begin ( in_range ) , ranges:: end ( in_range ) ,
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 хранилище оставлено запрещенным

Смотрите также

перемещает заданное количество объектов в неинициализированную область памяти
(функциональный объект алгоритма)
перемещает диапазон объектов в неинициализированную область памяти
(шаблон функции)