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

void assign( size_type count, const T& value );	(1)
template< class InputIt > void assign( InputIt first, InputIt last );	(2)
void assign( std::initializer_list<T> ilist );	(3)	(с C++11)

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

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

2) Заменяет содержимое на копии элементов в диапазоне [first, ). Поведение не определено, если любой из аргументов является итератором в *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::list<char>:

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

Вывод:

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

Отчёты об ошибках

Следующие отчёты об ошибках, изменяющие поведение, были применены ретроактивно к ранее опубликованным стандартам C++.

DR	Применён к	Поведение, как опубликовано	Корректное поведение
LWG 320	C++98	операция замены была определена как удаление всех существующих элементов, за которым следует вставка заданных элементов	удаление определения

См. также

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

строит list
(публичный член-функция)

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