Namespaces
Variants

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

From cppreference.net

C++
Containers library
std::vector
Member types
Member functions
Non-member functions
(until C++20) (until C++20) (until C++20) (until C++20) (until C++20)
Deduction guides (C++17)
template < container-compatible-range < T > R >
constexpr void assign_range ( R && rg ) ;
(since C++23)

Replaces elements in the container with a copy of each element in rg .

All iterators (including the end() iterator) and all references to the elements are invalidated.

Each iterator in the range rg is dereferenced exactly once.

If rg overlaps with * this , the behavior is undefined.

Contents

Parameters

rg - an input_range with reference type convertible to the element type of the container
Type requirements
-
If std:: assignable_from < T & , ranges:: range_reference_t < R >> is not modeled, the program is ill-formed.
-
If T is not EmplaceConstructible into vector from * ranges:: begin ( rg ) , the behavior is undefined.
-
If any of the following conditions is satisfied, and T is not MoveInsertable into vector , the behavior is undefined:
(until C++26)
(since C++26)

Notes

Feature-test macro Value Std Feature
__cpp_lib_containers_ranges 202202L (C++23) Ranges-aware construction and insertion

Example

Run this code 
#include <algorithm>
#include <cassert>
#include <vector>
#include <list>
int main()
{
    const auto source = std::list{2, 7, 1};
    auto destination = std::vector{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));
}

See also

(C++23)
inserts a range of elements
(public member function)
(C++23)
adds a range of elements to the end
(public member function)
assigns values to the container
(public member function)
assigns values to the container
(public member function)