Namespaces
Variants

std:: inserter

From cppreference.net
Iterator library
Iterator concepts
Iterator primitives
Algorithm concepts and utilities
Indirect callable concepts
Common algorithm requirements
(C++20)
(C++20)
(C++20)
Utilities
(C++20)
Iterator adaptors
Range access
(C++11) (C++14)
(C++14) (C++14)
(C++11) (C++14)
(C++14) (C++14)
(C++17) (C++20)
(C++17)
(C++17)
헤더 파일에 정의됨 <iterator>
template < class Container >

std:: insert_iterator < Container >

inserter ( Container & c, typename Container :: iterator i ) ;
(C++20 이전)
template < class Container >

constexpr std:: insert_iterator < Container >

inserter ( Container & c, ranges:: iterator_t < Container > i ) ;
(C++20 이후)

inserter 는 컨테이너 c 와 해당 반복자 i 에 대해 인자 타입에서 추론된 타입으로 std::insert_iterator 를 생성하는 편의 함수 템플릿입니다.

목차

매개변수

c - insert 연산을 지원하는 컨테이너
i - c 내에서 삽입 위치를 나타내는 반복자

반환값

컨테이너 c i 가 가리키는 위치에 요소들을 삽입하는 데 사용할 수 있는 std::insert_iterator 입니다.

가능한 구현

template<class Container>
std::insert_iterator<Container> inserter(Container& c, typename Container::iterator i)
{
    return std::insert_iterator<Container>(c, i);
}

예제

#include <algorithm>
#include <iostream>
#include <iterator>
#include <set>
#include <vector>
int main()
{
    std::multiset<int> s{1, 2, 3};
    // std::inserter는 일반적으로 multi-set과 함께 사용됨
    std::fill_n(std::inserter(s, s.end()), 5, 2);
    for (int n : s)
        std::cout << n << ' ';
    std::cout << '\n';
    std::vector<int> d{100, 200, 300};
    std::vector<int> v{1, 2, 3, 4, 5};
    // 시퀀스 컨테이너에 삽입할 때, 삽입 지점이 진행됨
    // 각 std::insert_iterator::operator=가 대상 반복자를 업데이트하기 때문
    std::copy(d.begin(), d.end(), std::inserter(v, std::next(v.begin())));
    for (int n : v)
        std::cout << n << ' ';
    std::cout << '\n';
}

출력:

1 2 2 2 2 2 2 3 
1 100 200 300 2 3 4 5

결함 보고서

다음의 동작 변경 결함 보고서들은 이전에 발표된 C++ 표준에 소급 적용되었습니다.

DR 적용 대상 게시된 동작 올바른 동작
LWG 561 C++98 i 의 타입이 Container 와 무관했음 Container 의 반복자 타입임

참고 항목

컨테이너에 삽입하기 위한 반복자 어댑터
(클래스 템플릿)
인자로부터 추론된 타입의 std::back_insert_iterator 를 생성함
(함수 템플릿)
인자로부터 추론된 타입의 std::front_insert_iterator 를 생성함
(함수 템플릿)