unordered_map::equal_range

更新 : 2007 年 11 月

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

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

パラメータ

• keyval
  検索するキー値。

解説

このメンバ関数は、[X.first, X.second) が keyval と同じ大小関係を持つ被制御シーケンスの要素のみを区切ることができるように、反復子のペア X を返します。このような要素が存在しない場合は、いずれの反復子も end() になります。

使用例

// std_tr1__unordered_map__unordered_map_equal_range.cpp 
// compile with: /EHsc 
#include <unordered_map> 
#include <iostream> 
 
typedef std::tr1::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); 
    } 
 

 [c, 3] [b, 2] [a, 1]
equal_range('x'):
equal_range('b'): [b, 2]

必要条件

ヘッダー : <unordered_map>

名前空間 : std::tr1

参照

参照

<unordered_map>

unordered_map クラス