unordered_map::equal_range

指定したキーに一致する範囲を検索します。

std::pair<iterator, iterator>
    equal_range(const Key& keyval);
std::pair<const_iterator, const_iterator>
    equal_range(const Key& keyval) const;

パラメーター

  • keyval
    検索するキー値。

解説

このメンバー関数は、被制御シーケンスの要素について、keyval と順序が等価な要素の範囲を示す反復子 X のペア [X.first, X.second) を返します。 このような要素が存在しなかった場合は、いずれの反復子も end() になります。

使用例

 

// std_tr1__unordered_map__unordered_map_equal_range.cpp 
// compile with: /EHsc 
#include <unordered_map> 
#include <iostream> 
 
typedef std::unordered_map<char, int> Mymap; 
int main() 
    { 
    Mymap c1; 
 
    c1.insert(Mymap::value_type('a', 1)); 
    c1.insert(Mymap::value_type('b', 2)); 
    c1.insert(Mymap::value_type('c', 3)); 
 
// display contents " [c 3] [b 2] [a 1]" 
    for (Mymap::const_iterator it = c1.begin(); 
        it != c1.end(); ++it) 
        std::cout << " [" << it->first << ", " << it->second << "]"; 
    std::cout << std::endl; 
 
// display results of failed search 
    std::pair<Mymap::iterator, Mymap::iterator> pair1 = 
        c1.equal_range('x'); 
    std::cout << "equal_range('x'):"; 
    for (; pair1.first != pair1.second; ++pair1.first) 
        std::cout << " [" << pair1.first->first 
            << ", " << pair1.first->second << "]"; 
    std::cout << std::endl; 
 
// display results of successful search 
    pair1 = c1.equal_range('b'); 
    std::cout << "equal_range('b'):"; 
    for (; pair1.first != pair1.second; ++pair1.first) 
        std::cout << " [" << pair1.first->first 
            << ", " << pair1.first->second << "]"; 
    std::cout << std::endl; 
 
    return (0); 
    } 
 
  

必要条件

ヘッダー: <unordered_map>

名前空間: std

参照

関連項目

<unordered_map>

unordered_map クラス

その他の技術情報

<unordered_map> メンバー