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

Inserta, en orden no inverso, copias de los elementos en rg antes de pos .

Si después de la operación el nuevo size() es mayor que la antigua capacity() ocurre una reasignación de memoria, en cuyo caso todos los iteradores (incluyendo el iterador end() ) y todas las referencias a los elementos quedan invalidados. De lo contrario, solo los iteradores y referencias anteriores al punto de inserción permanecen válidos.

Cada iterador en el rango rg es desreferenciado exactamente una vez.

Si rg se superpone con * this , el comportamiento es indefinido.

Parámetros

Valor de retorno

Un iterador al primer elemento insertado en * this , o pos si rg está vacío.

Notas

Ejemplo

#include <algorithm>
#include <cassert>
#include <iterator>
#include <vector>
#include <list>
int main()
{
    auto container = std::vector{1, 2, 3, 4};
    auto pos = std::next(container.begin(), 2);
    assert(*pos == 3);
    const auto rg = std::list{-1, -2, -3};
#ifdef __cpp_lib_containers_ranges
    container.insert_range(pos, rg);
#else
    container.insert(pos, rg.cbegin(), rg.cend());
#endif
    assert(std::ranges::equal(container, std::vector{1, 2, -1, -2, -3, 3, 4}));
}

Véase también