public member function
<map>

std::multimap::end

      iterator end();const_iterator end() const;
      iterator end() noexcept;const_iterator end() const noexcept;
返回指向末尾的迭代器
返回一個指向 multimap 容器中“尾後”元素的迭代器。

“尾後”元素是 multimap 容器中最後一個元素之後的理論上的元素。它不指向任何元素,因此不應被解引用。

由於標準庫函式使用的範圍不包括其結束迭代器所指向的元素,此函式通常與 multimap::begin 結合使用,以指定包含容器中所有元素的範圍。

如果容器為空,此函式返回的迭代器與 multimap::begin 返回的相同。

引數



返回值

指向容器中“尾後”元素的迭代器。

如果multimap物件是const限定的,則該函式返回一個const_iterator。否則,它返回一個iterator.

成員型別iteratorconst_iterator雙向迭代器 型別,指向元素。

示例

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

int main ()
{
  std::multimap<char,int> mymultimap;

  mymultimap.insert (std::pair<char,int>('a',10));
  mymultimap.insert (std::pair<char,int>('b',20));
  mymultimap.insert (std::pair<char,int>('b',150));

  // show content:
  for (std::multimap<char,int>::iterator it=mymultimap.begin(); it!=mymultimap.end(); ++it)
    std::cout << (*it).first << " => " << (*it).second << '\n';

  return 0;
}

輸出
a => 10
b => 20
b => 150


複雜度

常量。

迭代器有效性

沒有變化。

資料競爭

訪問容器(const 和非 const 版本都不會修改容器)。
呼叫該函式不訪問任何包含的元素,但返回的迭代器可用於訪問或修改元素。併發訪問或修改不同元素是安全的。

異常安全

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

另見