public member function
<map>

std::multimap::rend

      reverse_iterator rend();const_reverse_iterator rend() const;
      reverse_iterator rend() nothrow;const_reverse_iterator rend() const nothrow;
返回指向反向末尾的反向迭代器
返回一個指向 multimap 容器中第一個元素之前的理論元素的反向迭代器(這被認為是它的反向尾部)。

multimap::rbeginmultimap::rend之間的範圍包含容器中的所有元素(按反向順序)。

引數



返回值

指向序列容器反向尾部的反向迭代器。

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

成員型別reverse_iteratorconst_reverse_iterator是元素的反向雙向迭代器型別。請參閱 multimap 成員型別

示例

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

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

  mymultimap.insert (std::make_pair('x',10));
  mymultimap.insert (std::make_pair('y',20));
  mymultimap.insert (std::make_pair('y',150));
  mymultimap.insert (std::make_pair('z',9));

  // show content:
  std::multimap<char,int>::reverse_iterator rit;
  for (rit=mymultimap.rbegin(); rit!=mymultimap.rend(); ++rit)
    std::cout << rit->first << " => " << rit->second << '\n';

  return 0;
}

輸出
z => 9
y => 150
y => 20
x => 10


複雜度

常量。

迭代器有效性

沒有變化。

資料競爭

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

異常安全

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

另見