Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C++

std::vector::push_back — añadir un elemento al final

Añade un elemento por copia o a partir de un valor r. Aprende cuándo una reasignación invalida los punteros y por qué el antiguo `end()` se invalida incluso sin reasignación.

Versión: ISO C++23; implementation support may vary

Sintaxis

#include <vector>

// Member declarations inside std::vector<T, Allocator> (C++23):
constexpr void push_back(const T& value);
constexpr void push_back(T&& value);

// Call on a non-const vector object v:
v.push_back(value);

std::vector::push_back es una función miembro del vector declarado en <vector>. Añade un elemento al final y devuelve void. La sobrecarga const T& copia el argumento y exige que T cumpla Cpp17CopyInsertable para ese vector. La sobrecarga T&& exige Cpp17MoveInsertable y construye el elemento a partir de un valor r; aún puede copiar si no hay constructor de movimiento y un constructor de copia acepta el argumento. std::move no mueve nada por sí solo. No des por hecho que un std::string queda vacío después de mover su valor.

Si la operación tiene éxito, size() aumenta en uno. capacity() indica cuántos elementos caben sin reasignar memoria. Una llamada correcta a reserve(n) garantiza una capacidad de al menos n, pero no crea elementos ni modifica size(). Añadir al final cuesta O(1) amortizado; una sola inserción con reasignación cuesta tiempo lineal respecto al tamaño del vector.

Si el nuevo tamaño supera la capacidad anterior, la reasignación invalida todos los punteros, referencias e iteradores existentes a elementos. Sin reasignación, siguen siendo válidos, pero cada inserción exitosa invalida el antiguo iterador end(). Por tanto, reservar capacidad no basta para añadir elementos de forma segura al mismo vector mientras lo recorres con un bucle for basado en rango.

Si falla la asignación de memoria, el vector queda intacto. La garantía fuerte ante excepciones también se aplica si T cumple Cpp17CopyInsertable o std::is_nothrow_move_constructible_v<T> vale true. En cambio, si lanza una excepción el constructor de movimiento de un tipo que no cumple Cpp17CopyInsertable, los efectos no están especificados.

Usa emplace_back(args...) para construir un elemento directamente a partir de los argumentos del constructor. Si un algoritmo necesita un iterador de salida, escribir mediante std::back_inserter(v), declarado en <iterator>, llama a v.push_back(...). El iterador v.end() no es un destino donde escribir nuevos elementos.

Ejemplos

#include <iostream>
#include <string>
#include <utility>
#include <vector>

int main() {
    std::vector<std::string> words;
    words.reserve(2);
    std::cout << words.size() << '\n';

    const std::string alpha{"alpha"};
    words.push_back(alpha);
    const std::string* first = &words.front();

    std::string beta{"beta"};
    words.push_back(std::move(beta));
    std::cout << words.size() << ' ' << *first << ' ' << words.back() << '\n';
}

Resultado

0
2 alpha beta

`reserve(2)` deja el tamaño en `0`. La primera llamada copia `alpha` y la segunda mueve el valor de `beta`. No hay reasignación, así que `first` sigue apuntando al primer elemento. El programa no lee `beta` después del movimiento.

Lecciones relacionadas

  • C++ · Lección 11 · Avanzado · Versión: 3
  • C++ · Lección 14 · Avanzado · Versión: 3
  • C++ · Lección 15 · Avanzado · Versión: 3
  • C++ · Lección 21 · Avanzado · Versión: 3
  • C++ · Lección 23 · Avanzado · Versión: 3
  • C++ · Lección 29 · Avanzado · Versión: 3
  • C++ · Lección 30 · Avanzado · Versión: 3
  • C++ · Lección 34 · Avanzado · Versión: 3
  • C++ · Lección 37 · Avanzado · Versión: 3
  • C++ · Lección 51 · Avanzado · Versión: 3
  • C++ · Lección 57 · Avanzado · Versión: 3
  • C++ · Lección 58 · Avanzado · Versión: 3
  • C++ · Lección 59 · Avanzado · Versión: 3

Fuentes