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

void push_back( const T& value );

void push_back( T&& value );

Ajoute l'élément donné value à la fin du conteneur.

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

Paramètres

Valeur de retour

(aucune)

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