Namespaces
Variants

std::forward_list<T,Allocator>:: insert_range_after

From cppreference.net
template < container-compatible-range < T > R >
iterator insert_range_after ( const_iterator pos, R && rg ) ;
(C++23부터)
(C++26부터 constexpr)

범위 rg 내 요소들의 복사본을 pos 뒤에 삽입합니다. 범위 rg 내 각 반복자는 정확히 한 번 역참조됩니다.

다음 조건 중 하나라도 충족되면, 동작은 정의되지 않습니다:

반복자나 참조가 무효화되지 않습니다.

목차

매개변수

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}));
}

참고 항목

시작 부분에 요소 범위를 추가함
(public member function)
요소 뒤에 요소들을 삽입함
(public member function)
요소 뒤에 제자리에서 요소들을 생성함
(public member function)