Difference between revisions of "Template:cpp/container/assign"
From cppreference.com
(+) |
m (Text replace - "{{concept" to "{{named req") |
||
| Line 21: | Line 21: | ||
{{rev begin}} | {{rev begin}} | ||
{{rev|until=c++11|This overload has the same effect as overload {{v|1}} if {{tt|InputIt}} is an integral type.}} | {{rev|until=c++11|This overload has the same effect as overload {{v|1}} if {{tt|InputIt}} is an integral type.}} | ||
| − | {{rev|since=c++11|{{cpp/enable if|{{tt|InputIt}} satisfies {{ | + | {{rev|since=c++11|{{cpp/enable if|{{tt|InputIt}} satisfies {{named req|InputIterator}}}}.}} |
{{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}}. | ||
Revision as of 14:25, 15 June 2018
| 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 LegacyInputIterator. |
(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}}})
|
