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


複雜度

未指定,但通常是恆定的。

迭代器有效性

沒有變化。

資料競爭

該物件被訪問。

異常安全

無異常保證:此成員函式從不丟擲異常。
還可以保證返回的迭代器的複製構造或賦值永遠不會引發異常。

另見