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

constexpr iterator insert( const_iterator pos, const T& value );

constexpr iterator insert( const_iterator pos, T&& value );

constexpr iterator insert( const_iterator pos, size_type count, const T& value );

template< class InputIt >
constexpr iterator insert( const_iterator pos, InputIt first, InputIt last );

constexpr iterator insert( const_iterator pos, std::initializer_list<T> ilist );

コンテナ内の指定された位置に要素を挿入します。

パラメータ

戻り値

計算量

挿入される要素の数に加えて、コンテナの pos と end() の間の距離に対して線形。

例外

• 呼び出し前に size ( ) == capacity ( ) の場合、 std::bad_alloc をスローする。この関数は副作用を持たない（ 強い例外安全保証 ）。
• 挿入される要素の初期化、または任意の LegacyInputIterator 操作によってスローされる例外。 [ ​ 0 ​ , pos ) の要素は変更されない。

例

#include <initializer_list>
#include <inplace_vector>
#include <iterator>
#include <new>
#include <print>
int main()
{
    std::inplace_vector<int, 14> v(3, 100);
    std::println("1. {}", v);
    auto pos = v.begin();
    pos = v.insert(pos, 200); // オーバーロード (1)
    std::println("2. {}", v);
    v.insert(pos, 2, 300); // オーバーロード (3)
    std::println("3. {}", v);
    int arr[] = {501, 502, 503};
    v.insert(v.begin(), arr, arr + std::size(arr)); // オーバーロード (4)
    std::println("4. {}", v);
    v.insert(v.end(), {601, 602, 603}); // オーバーロード (5)
    std::println("5. {}", v);
    const auto list = {-13, -12, -11};
    try
    {
        v.insert(v.begin(), list); // スロー: 空き領域なし
    }
    catch(const std::bad_alloc&)
    {
        std::println("bad_alloc: v.capacity()={} < v.size()={} + list.size()={}",
                     v.capacity(), v.size(), list.size());
    }
}

1. [100, 100, 100]
2. [200, 100, 100, 100]
3. [300, 300, 200, 100, 100, 100]
4. [501, 502, 503, 300, 300, 200, 100, 100, 100]
5. [501, 502, 503, 300, 300, 200, 100, 100, 100, 601, 602, 603]
bad_alloc: v.capacity()=14 < v.size()=12 + list.size()=3

関連項目