C++ Forward_list 库 - before_begin() 函数

---

描述

C++函数std::forward_list::before_begin()返回一个随机访问迭代器，它指向forward_list的第一个元素之前的位置。

该迭代器可以与emplace_after、erase_after、insert_after和splice_after一起使用。

宣言

以下是 std::forward_list::before_begin() 函数形式 std::forward_list 标头的声明。

C++11

iterator before_begin() noexcept;
const_iterator before_begin() const noexcept;

参数

没有任何

返回值

如果forward_list对象是常量限定的，则方法返回常量随机访问迭代器，否则返回非常量随机访问迭代器。

例外情况

该成员函数从不抛出异常。

时间复杂度

常数即 O(1)

例子

以下示例显示了 std::forward_list::before_begin() 函数的用法。

#include <iostream>
#include <forward_list>

using namespace std;

int main(void) {

   forward_list<int> fl = {2, 3, 4, 5};
   auto it = fl.before_begin();

   fl.insert_after(it, 1);

   cout << "List contains following elements" << endl;

   for (auto it = fl.begin(); it != fl.end(); ++it)
      cout << *it << endl;

   return 0;
}

让我们编译并运行上面的程序，这将产生以下结果 -

List contains following elements
1
2
3
4
5