Namespaces
Variants

std::list<T,Allocator>:: operator=

From de.cppreference.net

list & operator = ( const list & other ) ;
(1) (constexpr seit C++26)
(2)
list & operator = ( list && other ) ;
(seit C++11)
(bis C++17)
list & operator = ( list && other )
noexcept ( /* siehe unten */ ) ;
(seit C++17)
(constexpr seit C++26)
list & operator = ( std:: initializer_list < value_type > ilist ) ;
(3) (seit C++11)
(constexpr seit C++26)

Ersetzt den Inhalt des Containers.

Sei traits gleich std:: allocator_traits < allocator_type > :

1) Kopierzuweisungsoperator. Ersetzt den Inhalt durch eine Kopie des Inhalts von other .

Wenn traits :: propagate_on_container_copy_assignment :: value true ist, wird der Allokator von * this durch eine Kopie von other ersetzt. Wenn der Allokator von * this nach der Zuweisung ungleich zu seinem alten Wert verglichen würde, wird der alte Allokator verwendet, um den Speicher freizugeben, danach wird der neue Allokator verwendet, um ihn vor dem Kopieren der Elemente zu allokieren. Andernfalls kann der von * this verwaltete Speicher wenn möglich wiederverwendet werden. In jedem Fall können die ursprünglich zu * this gehörenden Elemente entweder zerstört oder durch elementweise Kopierzuweisung ersetzt werden.

(seit C++11)
2) Move-Zuweisungsoperator. Ersetzt die Inhalte durch die von other unter Verwendung von Move-Semantik (d.h. die Daten in other werden von other in diesen Container verschoben). other befindet sich danach in einem gültigen aber unspezifizierten Zustand.
Wenn traits :: propagate_on_container_move_assignment :: value true ist, wird der Allokator von * this durch eine Kopie des Allokators von other ersetzt. Wenn er false ist und die Allokatoren von * this und other nicht gleich sind, kann * this nicht den Besitz des von other belegten Speichers übernehmen und muss jedes Element einzeln per Move-Zuweisung übertragen, wobei bei Bedarf zusätzlicher Speicher mit dem eigenen Allokator allokiert wird. In jedem Fall werden alle Elemente, die ursprünglich zu * this gehörten, entweder zerstört oder durch elementweise Move-Zuweisung ersetzt.
3) Ersetzt den Inhalt durch den durch die Initialisiererliste ilist identifizierten Inhalt.

Inhalt

Parameter

other - anderer Container, der als Datenquelle verwendet werden soll
ilist - Initialisierungsliste, die als Datenquelle verwendet werden soll

Rückgabewert

* this

Komplexität

1) Linear in der Größe von * this und other .
2) Linear in der Größe von * this , es sei denn, die Allokatoren vergleichen sich nicht gleich und propagieren nicht, in welchem Fall linear in der Größe von * this und other .
3) Linear in der Größe von * this und ilist .

Ausnahmen

2)
noexcept Spezifikation:
noexcept ( std:: allocator_traits < Allocator > :: is_always_equal :: value )
(seit C++17)

Hinweise

Nach der Container-Move-Zuweisung (Überladung (2)) bleiben, sofern die elementweise Verschiebungszuweisung nicht durch inkompatible Allokatoren erzwungen wird, Referenzen, Zeiger und Iteratoren, die ursprünglich auf Elemente in other verwiesen, gültig, verweisen aber nun auf Elemente, die sich in *this befinden. Der aktuelle Standard garantiert dies durch die pauschale Aussage in [container.reqmts]/67, und eine direktere Garantie wird via LWG issue 2321 in Betracht gezogen.

Beispiel

Der folgende Code verwendet operator = um eine std::list einer anderen zuzuweisen:

#include <initializer_list>
#include <iostream>
#include <iterator>
#include <list>
void print(const auto comment, const auto& container)
{
    auto size = std::size(container);
    std::cout << comment << "{ ";
    for (const auto& element : container)
        std::cout << element << (--size ? ", " : " ");
    std::cout << "}\n";
}
int main()
{
    std::list<int> x{1, 2, 3}, y, z;
    const auto w = {4, 5, 6, 7};
    std::cout << "Initially:\n";
    print("x = ", x);
    print("y = ", y);
    print("z = ", z);
    std::cout << "Copy assignment copies data from x to y:\n";
    y = x;
    print("x = ", x);
    print("y = ", y);
    std::cout << "Move assignment moves data from x to z, modifying both x and z:\n";
    z = std::move(x);
    print("x = ", x);
    print("z = ", z);
    std::cout << "Assignment of initializer_list w to z:\n";
    z = w;
    print("w = ", w);
    print("z = ", z);
}

Ausgabe:

Initially:
x = { 1, 2, 3 }
y = { }
z = { }
Copy assignment copies data from x to y:
x = { 1, 2, 3 }
y = { 1, 2, 3 }
Move assignment moves data from x to z, modifying both x and z:
x = { }
z = { 1, 2, 3 }
Assignment of initializer_list w to z:
w = { 4, 5, 6, 7 }
z = { 4, 5, 6, 7 }

Siehe auch

konstruiert die list
(public member function)
weist Werte dem Container zu
(public member function)