std::insert_iterator
| ヘッダ <iterator>
|
||
template< class Container >
class insert_iterator : public std::iterator<std::output_iterator_tag,
void, void, void, void>
|
(C++17 まで) | |
template< class Container >
class insert_iterator;
|
(C++17 以降) | |
std::insert_iterator は LegacyOutputIterator であり、構築時に指定されたコンテナに対して、与えられたイテレータが指す位置に要素を挿入します。このイテレータ（逆参照されているかどうかに関わらず）に代入が行われるたびに、コンテナの insert() メンバ関数が呼び出されます。std::insert_iterator のインクリメントは何も行いません。
メンバー型
| メンバー型 | 定義 | ||||
iterator_category
|
std:: output_iterator_tag | ||||
value_type
|
void | ||||
difference_type
|
|
||||
pointer
|
void | ||||
reference
|
void | ||||
container_type
|
Container
|
|
メンバ型
|
(C++17まで) |
メンバー関数
新しい
insert_iterator
を構築する
(public member function) |
|
|
関連付けられたコンテナにオブジェクトを挿入する
(public member function) |
|
|
何も行わない
(public member function) |
|
|
何も行わない
(public member function) |
メンバーオブジェクト
| メンバー名 | 定義 |
container
(protected member object)
|
Container*型のポインタ
|
iter
(protected member object)
|
Container::iterator
(until C++20)
ranges::iterator_t<Container>
(since C++20)
型のイテレータ
|
例
#include <algorithm>
#include <iostream>
#include <iterator>
#include <list>
#include <vector>
int main()
{
std::vector<int> v{1, 2, 3, 4, 5};
std::list<int> l{-1, -2, -3};
std::copy(v.begin(), v.end(), // may be simplified with std::inserter
std::insert_iterator<std::list<int>>(l, std::next(l.begin())));
for (int n : l)
std::cout << n << ' ';
std::cout << '\n';
}
出力:
-1 1 2 3 4 5 -2 -3
関連項目
|
引数から推論された型の
std::insert_iterator
を作成する
(関数テンプレート) |
|
|
コンテナの末尾への挿入用イテレータアダプタ
(クラステンプレート) |
|
|
コンテナの先頭への挿入用イテレータアダプタ
(クラステンプレート) |