forward_list::insert_after

iterator insert_after ( const_iterator position, const value_type& val );

iterator insert_after ( const_iterator position, value_type&& val );

iterator insert_after ( const_iterator position, size_type n, const value_type& val );

template <class InputIterator>
  iterator insert_after ( const_iterator position, InputIterator first, InputIterator last );

iterator insert_after ( const_iterator position, initializer_list<value_type> il );

☲  参数

position

在容器中插入新元素的位置。
成员类型const_iterator是指向元素的前向迭代器类型。

val

要复制(或移动)插入元素的值。
成员类型value_type是容器中元素的类型，在forward_list中定义为第一个模板形参(T)的别名。

n

要插入的元素数。每个元素都被初始化为val的副本。
成员类型size_type是一个无符号整型。

first, last

指定元素范围的迭代器。range [first,last]中的元素的副本被插入到position位置(按照相同的顺序)。
注意，该范围包括first和last之间的所有元素，包括first所指向的元素，但不包括last所指向的元素。
函数模板实参InputIterator必须是一个输入迭代器类型，该类型指向可以构造value_type对象的类型的元素。

il

一个initializer_list对象。这些元素的副本在position处插入(按照相同的顺序)。 这些对象是由初始化列表声明符自动构造的。
成员类型value_type是容器中元素的类型，在forward_list中定义为第一个模板形参(T)的别名。

☉  返回值

☣  示例

// forward_list::insert_after
#include <iostream>
#include <array>
#include <forward_list>

int main ()
{
  std::array<int,3> myarray = { 11, 22, 33 };
  std::forward_list<int> mylist;
  std::forward_list<int>::iterator it;

  it = mylist.insert_after ( mylist.before_begin(), 10 );          // 10
                                                                   //  ^  <- it
  it = mylist.insert_after ( it, 2, 20 );                          // 10 20 20
                                                                   //        ^
  it = mylist.insert_after ( it, myarray.begin(), myarray.end() ); // 10 20 20 11 22 33
                                                                   //                 ^
  it = mylist.begin();                                             //  ^
  it = mylist.insert_after ( it, {1,2,3} );                        // 10 1 2 3 20 20 11 22 33
                                                                   //        ^

  std::cout << "mylist contains:";
  for (int& x: mylist) std::cout << ' ' << x;
  std::cout << '\n';
  return 0;
}

✥ 复杂度

☣ 迭代器的有效性

⇄ 数据竞争

☂ 异常安全性

🍄  另请参阅