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
}

参见