std::insert_iterator<Container>::operator=
From cppreference.com
< cpp | iterator | insert iterator
C++
Iterator library
Iterator concepts | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Iterator primitives | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Algorithm concepts and utilities | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Indirect callable concepts | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Common algorithm requirements | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Utilities | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Iterator adaptors | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
std::insert_iterator
Member functions | ||||
insert_iterator::operator= | ||||
(1) | ||
insert_iterator<Container>
&
operator= ( typename Container:: const_reference value ) ; |
(until C++11) | |
insert_iterator<Container>
&
operator= ( const typename Container:: value_type & value ) ; |
(since C++11) (until C++20) |
|
constexpr insert_iterator<Container>
&
operator= ( const typename Container:: value_type & value ) ; |
(since C++20) | |
(2) | ||
insert_iterator<Container>
&
operator= ( typename Container:: value_type && value ) ; |
(since C++11) (until C++20) |
|
constexpr insert_iterator<Container>
&
operator= ( typename Container:: value_type && value ) ; |
(since C++20) | |
Inserts the given value value to the container.
1) Results in
iter = container-
>insert(iter, value)
;
++iter;
2) Results in
iter = container-
>insert(iter, std::
move
(value)
)
;
++iter;
Parameters
value | - | the value to insert |
Return value
*this
Notes
This function exploits the signature compatibility between hinted insert for associative containers (such as std::set::insert) and positional insert for sequential containers (such as std::vector::insert
Example
Run this code
#include <deque> #include <iostream> #include <iterator> int main() { std::deque<int> q; std::insert_iterator<std::deque<int>> it(q, q.begin()); for (int i = 0; i < 10; ++i) it = i; // inserts i for (auto& elem : q) std::cout << elem << ' '; std::cout << '\n'; }
Output:
0 1 2 3 4 5 6 7 8 9