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

void push_back( const T& value );

void push_back( T&& value );

Añade el elemento dado value al final del contenedor.

Si después de la operación el nuevo size() es mayor que el anterior capacity(), se produce una reasignación, en cuyo caso todos los iteradores (incluyendo el iterador end()) y todas las referencias a los elementos se invalidan. De lo contrario, solo se invalida el iterador end().

Parámetros

Valor de retorno

(ninguno)

Complejidad

Constante amortizada.

Excepciones

Si se lanza una excepción (que puede ser debido a Allocator::allocate() o al constructor/operador de asignación de copia/desplazamiento de elementos), esta función no tiene efecto ( garantía fuerte de excepción ).

Notas

Algunas implementaciones lanzan std::length_error cuando push_back provoca una realocación que excede max_size (debido a una llamada implícita a un equivalente de reserve ( size () + 1)) .

Ejemplo

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

Véase también