std::inplace_vector<T,N>::insert_range

template< container-compatible-range<T> R >
constexpr iterator insert_range( const_iterator pos, R&& rg );

비반전 순서로 rg의 요소 복사본을 pos 앞에 삽입합니다.

범위 rg의 각 반복자는 정확히 한 번 역참조됩니다.

rg은(는) 컨테이너와 겹쳐서는 안 됩니다. 그렇지 않으면 동작이 정의되지 않습니다.

매개변수

반환값

* this 에 삽입된 첫 번째 요소를 가리키는 반복자, 또는 rg 가 비어 있을 경우 pos 를 반환합니다.

예외

• std::bad_alloc 이 발생하는 경우 - ranges:: distance ( rg ) + size ( ) > capacity ( ) 일 때. * this 의 요소들은 수정되지 않음.
• 삽입 작업 중 발생하는 모든 예외 (즉, T 의 복사/이동 생성자, 이동/복사 할당 연산자 또는 LegacyInputIterator 연산에 의해 발생하는 예외). * this 의 [ ​ 0 ​ , pos ) 범위 내 요소들은 수정되지 않음.

예제

#include <cassert>
#include <inplace_vector>
#include <iterator>
#include <new>
#include <print>
int main()
{
    auto v = std::inplace_vector<int, 8>{0, 1, 2, 3};
    auto pos = std::next(v.begin(), 2);
    assert(*pos == 2);
    const auto rg = {-1, -2, -3};
    v.insert_range(pos, rg);
    std::println("{}", v);
    try
    {
        assert(v.size() + rg.size() > v.capacity());
        v.insert_range(pos, rg); // throws: no space
    }
    catch(const std::bad_alloc& ex)
    {
        std::println("{}", ex.what());
    }
}

[0, 1, -1, -2, -3, 2, 3]
std::bad_alloc

참고 항목