std::insert_iterator

<metanoindex/>

 

C++

Поддержка компилятором

Автономные и размещённые реализации

Язык

Стандартная библиотека

Заголовки стандартной библиотеки

Требования к именованию

Макросы тестирования функциональности (C++20)

Поддержка языка

Библиотека концептов (C++20)

Библиотека метапрограммирования (C++11)

Библиотека диагностики

Библиотека общих утилит

Библиотека строк

Библиотека контейнеров

Библиотека итераторов

Библиотека диапазонов (C++20)

Библиотека алгоритмов

Библиотека численных данных

Библиотека ввода/вывода

Библиотека локализаций

Регулярные выражения (C++11)

Атомарные операции (C++11)

Библиотека поддержки конкуренции (C++11)

Библиотека файловой системы (C++17)

Технические спецификации

Указатель символов

Внешние библиотеки

 

Библиотека итераторов

Концепты итераторов
indirectly_readable (C++20) indirectly_writable (C++20) weakly_incrementable (C++20) incrementable (C++20) input_or_output_iterator (C++20) sentinel_for (C++20) sized_sentinel_for (C++20)	input_iterator (C++20) output_iterator (C++20) forward_iterator (C++20) bidirectional_iterator (C++20) random_access_iterator (C++20) contiguous_iterator (C++20)
Примитивы итераторов
iterator_traits input_iterator_tagoutput_iterator_tagforward_iterator_tagbidirectional_iterator_tagrandom_access_iterator_tagcontiguous_iterator_tag (C++20) iterator (устарело в C++17)	incrementable_traits (C++20) indirectly_readable_traits (C++20) iter_value_titer_difference_titer_reference_titer_rvalue_reference_titer_common_reference_t (C++20)(C++20)(C++20)(C++20)(C++20)
Концепты алгоритмов и утилиты
Косвенно вызываемые концепты
indirectly_unary_invocableindirectly_regular_unary_invocable (C++20)(C++20)   indirect_unary_predicate (C++20)	indirect_binary_predicate (C++20) indirect_equivalence_relation (C++20) indirect_strict_weak_order (C++20)
Общие требования к алгоритмам
indirectly_movable (C++20) indirectly_movable_storable (C++20) indirectly_copyable (C++20) indirectly_copyable_storable (C++20)	indirectly_swappable (C++20) indirectly_comparable (C++20) permutable (C++20) mergeable (C++20) sortable (C++20)
Утилиты
indirect_result_t (C++20)	projected (C++20)
Адаптеры итераторов
reverse_iterator move_iterator (C++11) move_sentinel (C++20) common_iterator (C++20) counted_iterator (C++20) back_insert_iterator front_insert_iterator insert_iterator	make_reverse_iterator (C++14) make_move_iterator (C++11) default_sentinel_tdefault_sentinel (C++20)(C++20) unreachable_sentinel_tunreachable_sentinel (C++20)(C++20) back_inserter front_inserter inserter
Потоковые итераторы
istream_iterator ostream_iterator	istreambuf_iterator ostreambuf_iterator
Точки настройки итераторов
ranges::iter_move (C++20)
ranges::iter_swap (C++20)
Операции итераторов
advance distance prev (C++11) next (C++11)	ranges::advance (C++20) ranges::distance (C++20) ranges::prev (C++20) ranges::next (C++20)
Доступ к диапазону
begincbegin (C++11)(C++14) endcend (C++11)(C++14) sizessize (C++17)(C++20)	rbegincrbegin (C++14)(C++14) rendcrend (C++14)(C++14) empty (C++17) data (C++17)

 

std::insert_iterator

Член функций Оригинал: Member functions Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

insert_iterator::insert_iterator

insert_iterator::operator=

insert_iterator::operator*

insert_iterator::operator++insert_iterator::operator++(int)

 

<tbody> </tbody>

Определено в заголовочном файле <iterator>
template< class Container > class insert_iterator : public std::iterator< std::output_iterator_tag, void,void,void,void >

std::insert_iterator является итератор вывода, который вставляет элементы в контейнер для которых она была построена, на позиции, на которую указывает итератор поставляется, используя insert() контейнера функция-член, когда итератор (будь разыменован или нет) назначен. Приращение std::insert_iterator является не-оп.

Оригинал:

std::insert_iterator is an output iterator that inserts elements into a container for which it was constructed, at the position pointed to by the supplied iterator, using the container's insert() member function whenever the iterator (whether dereferenced or not) is assigned to. Incrementing the std::insert_iterator is a no-op.

Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

Типы-члены

Тип члена	Определение
container_type	Container

Функции-члены

Шаблон:cpp/iterator/inserter/dsc operator++

(конструктор)	создает новый insert_iterator Оригинал: constructs a new insert_iterator Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда. (public функция-элемент)
operator=	Вставка объекта в соответствующий контейнер Оригинал: inserts an object into the associated container Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда. (public функция-элемент)
operator*	нет операции (public функция-элемент)

Член объектов

Имя пользователя Оригинал: Member name Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.	Definition
container (защищены)	указатель типа Container* Оригинал: a pointer of type Container* Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
iter (защищены)	итератор типа Container::iterator Оригинал: an iterator of type Container::iterator Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

Типы элементы

Тип элемент	Определение
iterator_category	std::output_iterator_tag
value_type	void
difference_type	void (до C++20) std::ptrdiff_t (начиная с C++20)
pointer	void
reference	void

Типы элемены iterator_category, value_type, difference_type, pointer и reference должны быть получены путём наследования от std::iterator<std::output_iterator_tag, void, void, void, void>.

(до C++17)

Пример

Запустить этот код

#include <vector>
#include <list>
#include <iostream>
#include <iterator>
#include <algorithm>
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

См. также

inserter	создаёт std::insert_iterator типа, выведенного из аргумента (шаблон функции)
back_insert_iterator	адаптер итератора для вставки в конец контейнера (шаблон класса)
front_insert_iterator	адаптер итератора для вставки в начало контейнера (шаблон класса)