std::forward_list<T,Allocator>:: insert_range_after
From cppreference.net
<
cpp
|
container
|
forward list
|
template
<
container-compatible-range
<
T
>
R
>
iterator insert_range_after ( const_iterator pos, R && rg ) ; |
(C++23부터)
(C++26부터 constexpr) |
|
범위 rg 내 요소들의 복사본을 pos 뒤에 삽입합니다. 범위 rg 내 각 반복자는 정확히 한 번 역참조됩니다.
다음 조건 중 하나라도 충족되면, 동작은 정의되지 않습니다:
-
T가forward_list에 EmplaceConstructible 가 아닙니다 * ranges:: begin ( rg ) 로부터. -
pos
가 범위
[before_begin(),end())내에 없습니다. - rg 와 * this 가 겹칩니다.
반복자나 참조가 무효화되지 않습니다.
목차 |
매개변수
| pos | - | 콘텐츠가 삽입될 위치의 뒤를 가리키는 반복자 |
| rg | - |
컨테이너 호환 범위
, 즉 요소들이
T
로 변환 가능한
input_range
|
반환값
마지막으로 삽입된 요소에 대한 반복자, 또는 pos 만약 rg 가 비어 있는 경우.
복잡도
크기에 선형적으로 비례하는 rg .
참고 사항
| 기능 테스트 매크로 | 값 | 표준 | 기능 |
|---|---|---|---|
__cpp_lib_containers_ranges
|
202202L
|
(C++23) | Ranges-aware 생성 및 삽입 |
예제
이 코드 실행
#include <algorithm> #include <cassert> #include <forward_list> #include <iterator> #include <vector> int main() { auto container = std::forward_list{1, 2, 3, 4}; auto pos = std::next(container.cbegin()); assert(*pos == 2); const auto rg = std::vector{-1, -2, -3}; #ifdef __cpp_lib_containers_ranges container.insert_range_after(pos, rg); #else container.insert_after(pos, rg.cbegin(), rg.cend()); #endif assert(std::ranges::equal(container, std::vector{1, 2, -1, -2, -3, 3, 4})); }
참고 항목
|
(C++23)
|
시작 부분에 요소 범위를 추가함
(public member function) |
|
요소 뒤에 요소들을 삽입함
(public member function) |
|
|
요소 뒤에 제자리에서 요소들을 생성함
(public member function) |