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

Fügt Kopien der Anfangselemente in rg vor end() ein, bis alle Elemente eingefügt sind oder der interne Speicher erschöpft ist (d.h. size ( ) == capacity ( ) den Wert true hat).

Alle Iteratoren und Referenzen bleiben gültig. Der end() Iterator wird ungültig.

Jeder Iterator in rg wird höchstens einmal dereferenziert.

Parameter

Rückgabewert

Ein Iterator, der auf das erste Element von rg zeigt, das nicht in * this eingefügt wurde, oder ranges:: end ( rg ) falls kein solches Element existiert.

Komplexität

Linear in der Anzahl der eingefügten Elemente.

Ausnahmen

Jede Ausnahme, die durch die Initialisierung des eingefügten Elements ausgelöst wird.

inplace_vector bietet die grundlegende Ausnahmesicherheitsgarantie , d.h. alle Elemente des Containers vor dem Aufruf werden erhalten, und alle bereits eingefügten Elemente (vor der Ausnahme, falls vorhanden) werden ebenfalls erhalten.

Hinweise

Beispiel

#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);
}

Siehe auch