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

rg 内の要素のコピーを、逆順にならない順序で pos の前に挿入します。

範囲内の各イテレータは rg 正確に1回デリファレンスされます。

rg が * this と重複する場合、動作は未定義です。

パラメータ

戻り値

* this に挿入された最初の要素を指すイテレータ、または rg が空の場合は pos を指すイテレータ。

例外

• std::bad_alloc 、もし ranges:: distance ( rg ) + size ( ) > capacity ( ) の場合。 * this の要素は変更されない。
• 挿入操作（すなわち T のコピー/ムーブコンストラクタ、ムーブ/コピー代入演算子）または任意の LegacyInputIterator 操作によって送出される例外。 * this の [ ​ 0 ​ , pos ) 範囲内の要素は変更されない。

例

#include <cassert>
#include <inplace_vector>
#include <iterator>
#include <new>
#include <print>
int main()
{
    auto v = std::inplace_vector<int, 8>{0, 1, 2, 3};
    auto pos = std::next(v.begin(), 2);
    assert(*pos == 2);
    const auto rg = {-1, -2, -3};
    v.insert_range(pos, rg);
    std::println("{}", v);
    try
    {
        assert(v.size() + rg.size() > v.capacity());
        v.insert_range(pos, rg); // throws: no space
    }
    catch(const std::bad_alloc& ex)
    {
        std::println("{}", ex.what());
    }
}

[0, 1, -1, -2, -3, 2, 3]
std::bad_alloc

関連項目