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

来自cppreference.com
 
C++
 
容器库
 
std::inplace_vector
成员类型
成员函数
非成员函数
 
<tbody> </tbody>
constexpr iterator insert( const_iterator pos, const T& value );
 (1) (C++26 起)
constexpr iterator insert( const_iterator pos, T&& value );
 (2) (C++26 起)
constexpr iterator insert( const_iterator pos, size_type count, const T& value );
 (3) (C++26 起)
template< class InputIt > constexpr iterator insert( const_iterator pos, InputIt first, InputIt last );
 (4) (C++26 起)
constexpr iterator insert( const_iterator pos, std::initializer_list<T> ilist );
 (5) (C++26 起)
See More

在容器中的指定位置插入元素。

1) 在 pos 之前插入 value 的副本。
2) 在 pos 之前插入 value，可能使用移动语义。
3) 在 pos 之前插入 count 个 value 的副本。
4) 在 pos 之前插入范围 [first, last) 的各元素。 此重载只有在 InputIt 为老式输入迭代器 (LegacyInputIterator) 时才会参与重载决议（以避免与重载 (3) 之间产生歧义）。
[first, last) 中的各个迭代器均被解引用一次。
如果 first 和 last 是 *this 中的迭代器，则其行为未定义。
5) 在 pos 之前插入初始化式列表 ilist 各元素。等价于：insert(pos, ilist.begin(), ilist.end());。
本节未完成

参数

pos - 要在其之前插入内容的迭代器。（pos 可以是 end() 迭代器）
value - 要插入的元素值
count - 要插入的元素数量
first, last - 要插入的源元素范围的迭代器对
ilist - 要插入其中各值的 std::initializer_list
类型要求
-
为使用重载 (1)， T 必须满足可复制插入 (CopyInsertable) 。
-
为使用重载 (2)， T 必须满足可移动插入 (MoveInsertable) 。
-
为使用重载 (3)， T 必须满足可复制赋值 (CopyAssignable) 和可复制插入 (CopyInsertable) 。
-
为使用重载 (4,5)， T 必须满足可就位构造 (EmplaceConstructible) 。

返回值

1,2) 指向所插入的 value 的迭代器。
3) 指向所插入第一个元素的迭代器，或当 count == 0 时返回 pos。
4) 指向所插入第一个元素的迭代器，或当 first == last 时返回 pos。
5) 指向所插入第一个元素的迭代器，或当 ilist 为空时返回 pos。

复杂度

与所插入元素数量加上 pos 与容器的 end() 之间的距离成线性。

异常

示例

运行此代码
#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

参阅

 原位构造元素
(公开成员函数) [编辑]
插入元素范围
(公开成员函数) [编辑]