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内の最大1回だけ間接参照されます。

パラメータ

戻り値

rg の最初の要素で * this に挿入されなかった要素を指すイテレータ、またはそのような要素が存在しない場合は ranges:: end ( rg ) を返します。

計算量

挿入される要素の数に対して線形です。

例外

挿入された要素の初期化によってスローされるあらゆる例外。

inplace_vector は basic exception safety guarantee を提供します。つまり、呼び出し前のコンテナの全要素が保持され、既に挿入された要素（例外発生前のものがあれば）もすべて保持されます。

注釈

例

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

関連項目