public member function
<forward_list>

std::forward_list::cbefore_begin

const_iterator cbefore_begin() const noexcept;
Return const_iterator to before beginning
返回一个const_iteratorpointing to the position before the first element in the container.

Aconst_iterator是一个指向常量内容的迭代器。这个迭代器可以像iteratorreturned by forward_list::before_begin, but it cannot be used to modify the contents it points to.

返回的值不应被解引用。

参数



返回值

Aconst_iteratorto the position before the beginning of the sequence.

成员类型const_iterator是一个指向 const 元素的 forward iterator 类型。

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
// forward_list::cbefore_begin
#include <iostream>
#include <forward_list>

int main ()
{
  std::forward_list<int> mylist = {77, 2, 16};

  mylist.insert_after ( mylist.cbefore_begin(), 19 );

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

  return 0;
}

输出
mylist contains: 19 77 2 16


复杂度

常量。

迭代器有效性

没有变化。

数据竞争

访问容器。
调用不访问任何容器中的元素,但返回的迭代器可用于访问它们。并发访问或修改不同元素是安全的。

异常安全

无异常保证:此成员函数从不抛出异常。
还可以保证返回的迭代器的复制构造或赋值永远不会引发异常。

另见