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

Добавляет копии начальных элементов из rg перед end() , пока все элементы не будут вставлены или внутреннее хранилище не будет исчерпано (т.е. size ( ) == capacity ( ) становится true ).

Все итераторы и ссылки остаются действительными. end() итератор становится недействительным.

Каждый итератор в rg разыменовывается не более одного раза.

Параметры

Возвращаемое значение

Итератор, указывающий на первый элемент rg , который не был вставлен в * this , или ranges:: end ( rg ) , если такого элемента не существует.

Сложность

Линейно по количеству вставленных элементов.

Исключения

Любое исключение, вызванное инициализацией вставляемого элемента.

inplace_vector предоставляет базовую гарантию безопасности исключений , то есть все элементы контейнера до вызова сохраняются, и все уже вставленные элементы (до исключения, если таковое возникло) также сохраняются.

Примечания

Пример

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

Смотрите также