multimap::rend

傳回處理成功最後一個項目的位置會反轉多重對應的 Iterator。

const_reverse_iterator rend( ) const; 
reverse_iterator rend( );

傳回值

處理成功最後一個項目的位置會反轉多重對應的反向雙向 Iterator (在 unreversed 多重對應的第一個項目之前) 的位置。

備註

如同 結束 搭配多重對應，rend 以相反的多重對應。

如果傳回值 rend 給 const_reverse_iterator，則無法修改多重對應物件。 如果傳回值 rend 給 reverse_iterator，則可以修改多重對應物件。

rend 可用來測試是否反向 Iterator 是否已到達的多重對應的結尾。

不應該取值 rend 所傳回的值。

範例

// multimap_rend.cpp
// compile with: /EHsc
#include <map>
#include <iostream>

int main( )
{
   using namespace std;
   multimap <int, int> m1;

   multimap <int, int> :: iterator m1_Iter;
   multimap <int, int> :: reverse_iterator m1_rIter;
   multimap <int, int> :: const_reverse_iterator m1_crIter;
   typedef pair <int, int> Int_Pair;

   m1.insert ( Int_Pair ( 1, 10 ) );
   m1.insert ( Int_Pair ( 2, 20 ) );
   m1.insert ( Int_Pair ( 3, 30 ) );

   m1_rIter = m1.rend( );
   m1_rIter--;
   cout << "The last element of the reversed multimap m1 is "
        << m1_rIter -> first << "." << endl;

   // begin can be used to start an iteration 
   // throught a multimap in a forward order
   cout << "The multimap is: ";
   for ( m1_Iter = m1.begin( ) ; m1_Iter != m1.end( ); m1_Iter++)
      cout << m1_Iter -> first << " ";
      cout << "." << endl;

   // rbegin can be used to start an iteration 
   // throught a multimap in a reverse order
   cout << "The reversed multimap is: ";
   for ( m1_rIter = m1.rbegin( ) ; m1_rIter != m1.rend( ); m1_rIter++)
      cout << m1_rIter -> first << " ";
      cout << "." << endl;

   // A multimap element can be erased by dereferencing to its key 
   m1_rIter = --m1.rend( );
   m1.erase ( m1_rIter -> first );

   m1_rIter = m1.rend( );
   m1_rIter--;
   cout << "After the erasure, the last element "
        << "in the reversed multimap is "
        << m1_rIter -> first << "." << endl;
}

需求

標頭：<map>

命名空間: std

請參閱

參考

multimap 類別

標準樣板程式庫