(C++17) | ||||
| Sequence | ||||
(C++11) | ||||
(C++26) | ||||
(C++26) | ||||
(C++11) | ||||
| Associative | ||||
| Unordered associative | ||||
(C++11) | ||||
(C++11) | ||||
(C++11) | ||||
(C++11) | ||||
| Adaptors | ||||
(C++23) | ||||
(C++23) | ||||
(C++23) | ||||
(C++23) | ||||
| Views | ||||
(C++20) | ||||
(C++23) | ||||
| Tables | ||||
| Iterator invalidation | ||||
| Member function table | ||||
| Non-member function table |
| Member functions | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Non-member functions | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Deduction guides(C++17) | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
template<container-compatible-range<T> R> void prepend_range( R&& rg); | (since C++23) (constexpr since C++26) | |
Inserts, in non-reversing order, copies of elements inrg beforebegin(). Each iterator in the rangerg is dereferenced exactly once.
No iterators or references are invalidated.
Contents |
| rg | - | acontainer compatible range, that is, aninput_range whose elements are convertible toT |
| Type requirements | ||
-IfT is notEmplaceConstructible intoforward_list from*ranges::begin(rg), the behavior is undefined. | ||
Linear in size ofrg.
| Feature-test macro | Value | Std | Feature |
|---|---|---|---|
__cpp_lib_containers_ranges | 202202L | (C++23) | Ranges-aware construction and insertion |
#include <algorithm>#include <cassert>#include <forward_list>#include <vector> int main(){auto container=std::forward_list{0,1,2,3};constauto rg=std::vector{-3,-2,-1}; #if __cpp_lib_containers_ranges container.prepend_range(rg);#else container.insert_after(container.before_begin(), rg.cbegin(), rg.cend());#endifassert(std::ranges::equal(container,std::forward_list{-3,-2,-1,0,1,2,3}));}
(C++23) | inserts a range of elements (public member function) |
(C++23) | inserts a range of elements after an element (public member function) |
| inserts an element to the beginning (public member function) | |
| constructs an element in-place at the beginning (public member function) |
