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

Ajoute une copie de value à la fin du conteneur.

Si après l'opération la nouvelle size() est supérieure à l'ancienne capacity() , une réallocation a lieu, auquel cas tous les itérateurs (y compris l'itérateur end() ) et toutes les références aux éléments sont invalidés. Sinon, seul l'itérateur end() est invalidé.

Paramètres

Complexité

Amorti constant.

Exceptions

Si une exception est levée (ce qui peut être dû à Allocator::allocate() ou au constructeur/opérateur d'affectation de copie/déplacement d'élément), cette fonction n'a aucun effet ( garantie d'exception forte ).

Notes

Certaines implémentations lancent std::length_error lorsque push_back provoque une réallocation qui dépasse max_size (en raison d'un appel implicite à un équivalent de reserve ( size () + 1)) .

Exemple

#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: ""

Voir aussi