std::inplace_vector<T,N>:: try_append_range

Añade copias de los elementos iniciales en rg antes de end() , hasta que todos los elementos sean insertados o se agote el almacenamiento interno (es decir, size ( ) == capacity ( ) sea true ).

Todos los iteradores y referencias permanecen válidos. El end() iterador queda invalidado.

Cada iterador en rg es desreferenciado como máximo una vez.

Parámetros

Valor de retorno

Un iterador que apunta al primer elemento de rg que no fue insertado en * this , o ranges:: end ( rg ) si no existe tal elemento.

Complejidad

Lineal en el número de elementos insertados.

Excepciones

Cualquier excepción lanzada por la inicialización del elemento insertado.

inplace_vector proporciona la garantía básica de seguridad ante excepciones , es decir, se preservan todos los elementos del contenedor anteriores a la llamada, y también se preservan todos los elementos ya insertados (antes de la excepción, si la hubiera).

Notas

Ejemplo

#include <cassert>
#include <initializer_list>
#include <inplace_vector>
int main()
{
    using I = std::inplace_vector<int, 8>;
    auto nums = I{1, 2, 3};
    const auto rg = {-1, -2, -3};
    auto it = nums.try_append_range(rg);
    assert(nums.size() == 6);
    assert((nums == I{1, 2, 3, -1, -2, -3}));
    assert(it == rg.end());
    it = nums.try_append_range(rg);
    assert(nums.size() == 8);
    assert((nums == I{1, 2, 3, -1, -2, -3, -1, -2}));
    assert(it == rg.begin() + 2);
}

Véase también