public member function
<map>

std::multimap::cbegin

const_iterator cbegin() const noexcept;
返回指向開頭的 const_iterator
返回一個const_iterator指向容器中的第一個元素。

Aconst_iterator是一個指向常量內容的迭代器。這個迭代器可以像iteratormultimap::begin 返回,但即使 multimap 物件本身不是 const,也不能用於修改它所指向的內容。

如果容器為空,則不應對返回的迭代器值進行解引用。

引數



返回值

Aconst_iterator指向序列的開頭。

成員型別const_iterator雙向迭代器 型別,指向 const 元素(型別為const value_type).
請注意,value_typemultimap 容器中是pair<const key_type, mapped_type> 的別名.

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
// multimap::cbegin/cend
#include <iostream>
#include <map>

int main ()
{
  std::multimap<char,int> mymultimap = { {'x',100}, {'y',200}, {'x',300} };

  // print content:
  std::cout << "mymultimap contains:";
  for (auto it = mymultimap.cbegin(); it != mymultimap.cend(); ++it)
    std::cout << " [" << it->first << ':' << it->second << ']';
  std::cout << '\n';

  return 0;
}

輸出
mymultimap contains: [x:100] [x:300] [y:200]


複雜度

常量。

迭代器有效性

沒有變化。

資料競爭

訪問容器。
呼叫不訪問任何容器中的元素,但返回的迭代器可用於訪問它們。併發訪問或修改不同元素是安全的。

異常安全

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

另見