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

template< container-compatible-range<T> R >
constexpr std::ranges::borrowed_iterator_t<R> try_append_range( R&& rg );

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

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

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

Параметры

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

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

Сложность

Линейная относительно числа вставленных элементов.

Исключения

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

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

Примечания

Пример

#include <cassert>
#include <initializer_list>
#include <inplace_vector>

int main()
{
#if defined(__cpp_lib_inplace_vector) and (__cpp_lib_inplace_vector < 202603L)
    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);
#endif
}

См. также