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
— это шаблон функции для удобства, который создаёт
std::insert_iterator
для контейнера
c
и его итератора
i
с типом, выведенным из типа аргумента.
Содержание |
Параметры
| c | - |
контейнер, поддерживающий операцию
insert
|
| i | - | итератор в c , указывающий позицию вставки |
Возвращаемое значение
Объект std::insert_iterator , который может использоваться для вставки элементов в контейнер c в позиции, указанной i .
Возможная реализация
template<class Container> std::insert_iterator<Container> inserter(Container& c, typename Container::iterator i) { return std::insert_iterator<Container>(c, i); } |
` был сохранен без изменений, как и требовалось. HTML-разметка и атрибуты также остались нетронутыми.
Пример
#include <algorithm> #include <iostream> #include <iterator> #include <set> #include <vector> int main() { std::multiset<int> s{1, 2, 3}; // std::inserter обычно используется с multi-sets 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 | Applied to | Behavior as published | Correct behavior |
|---|---|---|---|
| LWG 561 | C++98 |
the type of
i
was independent of
Container
|
it is the iterator type of
Container
|
Смотрите также
|
адаптер итератора для вставки в контейнер
(шаблон класса) |
|
|
создаёт
std::back_insert_iterator
типа, выведенного из аргумента
(шаблон функции) |
|
|
создаёт
std::front_insert_iterator
типа, выведенного из аргумента
(шаблон функции) |