Namespaces
Variants

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

From cppreference.net

C++
Containers library
std::inplace_vector
Member types
Member functions
Non-member functions
template < container-compatible-range < T > R >
constexpr void append_range ( R && rg ) ;
(C++26부터)

rg 범위의 요소들을 비역순으로 end() 앞에 복사본을 삽입합니다.


rg 내의 각 iterator는 정확히 한 번 역참조됩니다.

목차

매개변수

rg - a container compatible range , that is, an input_range whose elements are convertible to T
타입 요구사항
-
만약 T 가 EmplaceConstructible 하지 않으면 inplace_vector 로부터 * ranges:: begin ( rg ) , 동작은 정의되지 않습니다.

복잡도

rg 의 크기에 선형적입니다. T 의 생성자 호출 횟수는 정확히 std :: ranges:: size ( rg ) ) 와 동일합니다.

예외

std::bad_alloc 을 던집니다, 만약 std :: ranges:: size ( rg ) > N 인 경우. 복사 생성자, 이동 생성자, 할당 연산자, 이동 할당 연산자 또는 T 의 연산이나 InputIterator 연산에 의해 예외가 발생한 경우를 제외하고, 다른 예외가 발생하면 아무런 효과도 없습니다. 그렇지 않고 예외가 발생하면, size ( ) >= n 이고 범위 [ ​ 0 ​ , n ) 내의 요소들은 수정되지 않습니다, 여기서 n 은 이 호출 전 size() 의 값입니다.

예제

이 코드 실행 
#include <cassert>
#include <inplace_vector>
#include <iostream>
int main()
{
    using I = std::inplace_vector<int, 8>;
    auto head = I{1, 2, 3, 4};
    const auto tail = {-5, -6, -7};
    head.append_range(tail);
    assert(head.size() == 7 and (head == I{1, 2, 3, 4, -5, -6, -7}));
    try
    {
        head.append_range(tail); // throws: no space
    }
    catch(const std::bad_alloc&)
    {
        std::cout << "std::bad_alloc\n";
    }
}

출력: 

std::bad_alloc

참고 항목

끝에 요소 범위를 추가 시도
(public member function)
요소 범위를 삽입
(public member function)
끝에 요소를 추가
(public member function)
끝에 제자리에서 요소를 생성
(public member function)