Namespaces
Variants

std::list<T,Allocator>:: assign_range

From cppreference.net

template < container-compatible-range < T > R >
void assign_range ( R && rg ) ;
(начиная с C++23)
(constexpr начиная с C++26)

Заменяет элементы в контейнере копией каждого элемента из rg .

Все итераторы (включая end() итератор) и все ссылки на элементы становятся недействительными.

Каждый итератор в диапазоне rg разыменовывается ровно один раз.

Если rg пересекается с * this , поведение не определено.

Содержание

Параметры

rg - an input_range с типом ссылки, конвертируемым в тип элемента контейнера
Требования к типам
-
Если std:: assignable_from < T & , ranges:: range_reference_t < R >> не выполняется, программа некорректна.
-
Если T не является EmplaceConstructible в list из * ranges:: begin ( rg ) , поведение не определено.

Примечания

Макрос тестирования возможностей Значение Стандарт Возможность
__cpp_lib_containers_ranges 202202L (C++23) Ranges-aware конструирование и вставка

Пример

#include <algorithm>
#include <cassert>
#include <list>
#include <vector>
int main()
{
    const auto source = std::vector{2, 7, 1};
    auto destination = std::list{3, 1, 4};
#ifdef __cpp_lib_containers_ranges
    destination.assign_range(source);
#else
    destination.assign(source.cbegin(), source.cend());
#endif
    assert(std::ranges::equal(source, destination));
}

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

вставляет диапазон элементов
(public member function)
добавляет диапазон элементов в начало
(public member function)
добавляет диапазон элементов в конец
(public member function)
присваивает значения контейнеру
(public member function)
присваивает значения контейнеру
(public member function)