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

CKTIS / C++

std::vector::insert — insertar elementos en un vector

Inserta un valor, varias copias, una lista de inicialización o un rango de iteradores antes de una posición. Usa el iterador devuelto y comprueba qué referencias siguen siendo válidas.

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

Sintaxis

/* <vector>, public members of std::vector<T, Allocator> in C++23 */
constexpr iterator insert(const_iterator pos, const T& value);
constexpr iterator insert(const_iterator pos, T&& value);
constexpr iterator insert(const_iterator pos, size_type count, const T& value);
template<class InputIt>
constexpr iterator insert(const_iterator pos, InputIt first, InputIt last);
constexpr iterator insert(const_iterator pos, std::initializer_list<T> values);

std::vector::insert es una función miembro de <vector> que modifica el vector v insertando elementos antes de pos. El parámetro pos, de tipo const_iterator, debe ser una posición válida de v: con v.cbegin() se inserta al principio y con v.cend() se añade al final. Devuelve un iterator al primer elemento insertado o a la misma posición que pos si no se insertó nada. No desreferencies el resultado si es igual a v.end().

insert(pos, value) con const T& copia un valor; la sobrecarga con T&& permite mover desde un valor de tipo rvalue. insert(pos, count, value) inserta count copias y insert(pos, {a, b}) inserta los elementos de la lista en orden. T debe cumplir los requisitos de construcción y asignación de la sobrecarga elegida; las sobrecargas de copia no sirven para un tipo que solo admite movimiento.

insert(pos, first, last) lee un rango semiabierto válido [first, last), sin incluir last. Los iteradores ordinarios de otro vector permiten copiar sus elementos; aplicar std::make_move_iterator a ambos extremos permite mover desde elementos modificables del origen si el tipo lo admite. No uses como origen iteradores del propio vector de destino: el comportamiento es indefinido aunque haya capacidad suficiente. Si hace falta, copia primero el rango en otro contenedor. insert_range(pos, range) es una función miembro distinta de C++23; su disponibilidad depende de la biblioteca.

Si el nuevo tamaño supera la capacidad anterior, la reasignación de memoria invalida todos los iteradores, punteros y referencias previos del destino, incluido el antiguo end(). Si se inserta al menos un elemento sin reasignación, solo siguen siendo válidos los anteriores al punto de inserción; el antiguo end() también queda invalidado. Usa el iterador devuelto u obtén iteradores nuevos. Con reasignación, el coste es lineal en el tamaño resultante; sin ella, es lineal en la suma del número de elementos insertados y la distancia de pos al final.

No todas las excepciones dejan el vector intacto. Un fallo de asignación de memoria no lo modifica, pero no hay una garantía general para las excepciones al copiar, mover o asignar elementos, ni para las de las operaciones de iteradores de entrada. Al insertar un solo elemento al final, una excepción deja el vector intacto si T es Cpp17CopyInsertable en ese vector o si std::is_nothrow_move_constructible_v<T> es verdadero. De lo contrario, si lanza una excepción el constructor de movimiento de un tipo que no cumple Cpp17CopyInsertable, los efectos no están especificados.

Ejemplos

#include <iostream>
#include <vector>

int main() {
    std::vector<int> metrics{10, 40};
    const std::vector<int> batch{20, 30};

    const auto first = metrics.insert(metrics.cbegin() + 1,
                                      batch.begin(), batch.end());

    std::cout << "first inserted: " << *first << '\n';
    std::cout << "metrics:";
    for (int value : metrics) {
        std::cout << ' ' << value;
    }
    std::cout << "\nsize: " << metrics.size() << '\n';
}

Resultado

first inserted: 20
metrics: 10 20 30 40
size: 4

`batch` es un vector distinto. Sus elementos se insertan antes de `40`; `*first` vale `20` y `metrics.size()` vale `4`. La salida es la misma tanto si se reasigna memoria como si no.

Lecciones relacionadas

  • C++ · Lección 14 · Avanzado · Versión: 3

Fuentes