std::vector<T,Allocator>:: push_back

Hängt eine Kopie von value am Ende des Containers an.

Falls nach der Operation die neue size() größer ist als die alte capacity() , findet eine Neuzuweisung statt, bei der alle Iteratoren (einschließlich des end() -Iterators) und alle Referenzen auf die Elemente ungültig werden. Andernfalls wird nur der end() -Iterator ungültig.

Parameter

Komplexität

Amortisiert konstant.

Ausnahmen

Wenn eine Exception ausgelöst wird (was aufgrund von Allocator::allocate() oder Element-Kopier-/Verschiebekonstruktor/-zuweisung geschehen kann), hat diese Funktion keine Wirkung ( starke Exception-Garantie ).

Hinweise

Einige Implementierungen werfen std::length_error , wenn push_back eine Neuzuweisung verursacht, die max_size überschreitet (aufgrund eines impliziten Aufrufs eines Äquivalents von reserve ( size () + 1)) .

Beispiel

#include <iomanip>
#include <iostream>
#include <string>
#include <vector>
int main()
{
    std::vector<std::string> letters;
    letters.push_back("abc");
    std::string s{"def"};
    letters.push_back(std::move(s));
    std::cout << "std::vector letters holds: ";
    for (auto&& e : letters)
        std::cout << std::quoted(e) << ' ';
    std::cout << "\nMoved-from string s holds: " << std::quoted(s) << '\n';
}

std::vector letters holds: "abc" "def"
Moved-from string s holds: ""

Siehe auch