hash_map::rend

注意事項
這個 API 已經過時。替代方案是 unordered_map 類別。

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

const_reverse_iterator rend( ) const; 
reverse_iterator rend( );

傳回值

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

備註

如同 結束 使用 hash_map，rend 以反轉 hash_map。

如果 rend 的傳回值指派給 const_reverse_iterator，則無法修改 hash_map 物件。 如果 rend 的傳回值指派給 reverse_iterator，則可以修改 hash_map 物件。

rend 可用來測試是否反向 Iterator 是否已到達 hash_map 結尾。

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

在 Visual C++ .NET 2003 中， <hash_map> 和 <hash_set> 標頭檔的成員不在 std 命名空間中，而是移至 stdext 命名空間。 如需詳細資訊，請參閱 stdext 命名空間。

範例

// hash_map_rend.cpp
// compile with: /EHsc
#include <hash_map>
#include <iostream>

int main( )
{
   using namespace std;
   using namespace stdext;
   hash_map <int, int> hm1;

   hash_map <int, int> :: iterator hm1_Iter;
   hash_map <int, int> :: reverse_iterator hm1_rIter;
   hash_map <int, int> :: const_reverse_iterator hm1_crIter;
   typedef pair <int, int> Int_Pair;

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

   hm1_rIter = hm1.rend( );
   hm1_rIter--;
   cout << "The last element of the reversed hash_map hm1 is "
        << hm1_rIter -> first << "." << endl;

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

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

   // A hash_map element can be erased by dereferencing to its key 
   hm1_rIter = --hm1.rend( );
   hm1.erase ( hm1_rIter -> first );

   hm1_rIter = hm1.rend( );
   hm1_rIter--;
   cout << "After the erasure, the last element "
        << "in the reversed hash_map is "
        << hm1_rIter -> first << "." << endl;
}

需求

標頭檔: <hash_map>

**命名空間：**stdext

請參閱

參考

hash_map 類別

標準樣板程式庫