Difference between revisions of "Template:cpp/container/assign"
From cppreference.com
D41D8CD98F (Talk | contribs) (+ C++03 23.1.1/9) |
(+) |
||
| Line 24: | Line 24: | ||
{{rev end}} | {{rev end}} | ||
@3@ Replaces the contents with the elements from the initializer list {{tt|ilist}}. | @3@ Replaces the contents with the elements from the initializer list {{tt|ilist}}. | ||
| + | |||
| + | All iterators, pointers and references to the elements of the container are invalidated. {{#switch:{{{1|}}}|vector|deque=The past-the-end iterator is also invalidated.}} | ||
===Parameters=== | ===Parameters=== | ||
Revision as of 23:40, 5 July 2016
| void assign( size_type count, const T& value ); |
(1) | (since {std}) |
| template< class InputIt > void assign( InputIt first, InputIt last ); |
(2) | (since {std}) |
| void assign( std::initializer_list<T> ilist ); |
(3) | (since C++11) |
Replaces the contents of the container.
1) Replaces the contents with
count copies of value value2) Replaces the contents with copies of those in the range
[first, last).
This overload has the same effect as overload (1) if InputIt is an integral type. |
(until C++11) |
This overload participates in overload resolution only if InputIt satisfies Template:concept. |
(since C++11) |
3) Replaces the contents with the elements from the initializer list
ilist.All iterators, pointers and references to the elements of the container are invalidated.
Contents |
Parameters
| count | - | the new size of the container |
| value | - | the value to initialize elements of the container with |
| first, last | - | the range to copy the elements from |
| ilist | - | initializer list to copy the values from |
Complexity
1) Linear in
count2) Linear in distance between
first and last3) Linear in ilist.size()
Example
The following code uses assign to add several characters to a std::{{{1}}}<char>:
Run this code
#include <{{{1}}}> #include <iostream> int main() { std::{{{1}}}<char> characters; characters.assign(5, 'a'); for (char c : characters) { std::cout << c << '\n'; } return 0; }
Output:
a a a a a
See also
constructs the (public member function of std::{{{1}}})
|
