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

void push_back( const T& value );

void push_back( T&& value );

Hängt das angegebene Element value an das Ende des Containers an.

Falls nach der Operation die neue size() größer als die alte capacity() ist, findet eine Neubelegung statt, in welchem Fall 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

Rückgabewert

(kein)

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