C++

参考

<string>

basic_string

public member function
<string>

std::basic_string::cbegin

const_iterator cbegin() const noexcept;
返回指向开头的 const_iterator
返回一个const_iteratorpointing to the first character of the string.

Aconst_iterator是一个指向常量内容的迭代器。这个迭代器可以像iteratorreturned by basic_string::begin, but it cannot be used to modify the contents it points to, even if the basic_string object is not itself const.

参数

无

返回值

Aconst_iteratorto the beginning of the string.

成员类型const_iterator是指向 const 字符的随机访问迭代器类型。

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
 
// string::cbegin/cend
#include <iostream>
#include <string>

int main ()
{
  std::string str ("Lorem ipsum");
  for (auto it=str.cbegin(); it!=str.cend(); ++it)
    std::cout << *it;
  std::cout << '\n';

  return 0;
}

输出
Lorem ipsum


复杂度

未指定，但通常是恒定的。

迭代器有效性

没有变化。

数据竞争

该对象被访问。

异常安全

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

另见

basic_string::begin
返回指向起始位置的迭代器 (公开成员函数)
basic_string::cend
返回指向末尾的 const_iterator (公开成员函数)
basic_string::crbegin
返回指向反向起始位置的 const_reverse_iterator (公开成员函数)