std::forward_list<T,Allocator>::assign

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)

Заменяет содержимое контейнера.

1) Заменяет содержимое на count копий значения value.

2) Заменяет содержимое на копии элементов из диапазона [first, last). Поведение не определено, если любой из аргументов является итератором в *this.

Этот перегрузчик имеет тот же эффект, что и перегрузчик (1), если `InputIt` является целочисленным типом.	(до C++11)
Этот перегрузчик участвует в разрешении перегрузки только если `InputIt` удовлетворяет LegacyInputIterator.	(с C++11)

3) Заменяет содержимое элементами из списка инициализации ilist.

Все итераторы, указатели и ссылки на элементы контейнера становятся недействительными.

Параметры

count	-	новый размер контейнера
value	-	значение для инициализации элементов контейнера
first, last	-	диапазон для копирования элементов
ilist	-	список инициализации для копирования значений

Сложность

1) Линейная относительно count.

2) Линейная относительно расстояния между first и last.

3) Линейная относительно ilist.size().

Пример

Следующий код использует assign для добавления нескольких символов в std::forward_list<char>:

#include <forward_list>
#include <iostream>
#include <string>
 
int main()
{
    std::forward_list<char> characters;
 
    auto print_forward_list = [&]()
    {
        for (char c : characters)
            std::cout << c << ' ';
        std::cout << '\n';
    };
 
    characters.assign(5, 'a');
    print_forward_list();
 
    const std::string extra(6, 'b');
    characters.assign(extra.begin(), extra.end());
    print_forward_list();
 
    characters.assign({'C', '+', '+', '1', '1'});
    print_forward_list();
}

Вывод:

a a a a a
b b b b b b
C + + 1 1

См. также

(конструктор)

создает forward_list
(общедоступный метод-член)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/container/forward_list/assign