C++ Forward_list 库 - cbefore_begin() 函数

---

描述

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

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

该成员函数获得的迭代器可以用来迭代容器，但不能用来修改它所指向的对象的内容，即使对象本身不是常量。

宣言

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

C++11

const_iterator cbefore_begin() const noexcept;

参数

没有任何

返回值

返回一个常量随机访问迭代器。

例外情况

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

时间复杂度

常数即 O(1)

例子

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

#include <iostream>
#include <forward_list>

using namespace std;

int main(void) {

   forward_list<int> fl = {2, 3, 4, 5};
   auto it = fl.cbefore_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