C++

参考

<string>

basic_string

public member function
<string>

std::basic_string::cend

const_iterator cend() const noexcept;
返回指向结尾的 const_iterator
返回一个const_iterator指向字符串末尾的下一个字符。

一个const_iterator是一个指向常量内容的迭代器。这个迭代器可以像迭代器由 basic_string::end 返回，即使 basic_string 对象本身不是常量，也不能用于修改它指向的内容。

如果对象是空字符串，则此函数返回与 basic_string::cbegin 相同的值。

返回的值不应被解引用。

参数

无

返回值

一个const_iterator到字符串的末尾的下一个位置。

成员类型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::end
返回指向末尾的迭代器 (公开成员函数)
basic_string::cbegin
返回指向起始位置的 const_iterator (公开成员函数)
basic_string::crend
返回指向反向末尾的 const_reverse_iterator (公开成员函数)