Namespaces
Variants
Views
Actions

std::forward_list::assign

From cppreference.com
< cpp‎ | container‎ | forward list
Revision as of 20:30, 31 May 2013 by P12bot (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
void assign( size_type count, const T& value );
(1) (since C++11)
template< class InputIt >
void assign( InputIt first, InputIt last );
(2) (since C++11)
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 value
2) Replaces the contents with copies of those in the range [first, last). This overload does not participate in overload resolution if InputIt does not satisfy InputIterator.(since C++11)
3) Replaces the contents with the elements from the initializer list ilist.

Contents

[edit] 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
Type requirements
-
InputIt must meet the requirements of InputIterator.

[edit] Complexity

1) Linear in count
2) Linear in distance between first and last
3) Linear in ilist.size()

[edit] Example

The following code uses assign to add several characters to a std::forward_list<char>:

#include <forward_list>
#include <iostream>
 
int main()
{
    std::forward_list<char> characters;
 
    characters.assign(5, 'a');
 
    for (char c : characters) {
        std::cout << c << '\n';
    } 
 
    return 0;
}

Output:

a
a
a
a
a

[edit] See also

constructs the forward_list
(public member function) [edit]