std:: inserter
| Iterator concepts | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Iterator primitives | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Algorithm concepts and utilities | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Indirect callable concepts | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Common algorithm requirements | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Utilities | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Iterator adaptors | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
定義先ヘッダ
<iterator>
|
||
|
template
<
class
Container
>
std::
insert_iterator
<
Container
>
|
(C++20以前) | |
|
template
<
class
Container
>
constexpr
std::
insert_iterator
<
Container
>
|
(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はマルチセットでよく使用される 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
を作成する
(関数テンプレート) |