名前空間
変種
操作

「cpp/container/multimap/equal range」の版間の差分

提供: cppreference.com
< cpp‎ | container‎ | multimap
細 (1版：Import from Dokuwiki)
 
(3人の利用者による、間の5版が非表示)
1行: 1行:
−
{{title|equal_range}}
+
{{|}}
−
Syntax:
+
  
−
<syntaxhighlight lang="cpp">
+
cpp/
−
    #include <map>
+
cppmultimap
−
    pair<iterator, iterator> equal_range( const key_type& key );
+
//multimap
−
    pair<const_iterator, const_iterator> equal_range( const key_type& key ) const;
+
://
−
</syntaxhighlight>
+
//range
−
 
+
//
−
equal_range()関数は、2つのイテレータを返します。一方は、キーを含む最初の要素を指し、もう一方はキーを含む最後の要素を指します。
+
//
−
 
+
///
−
たとえば、次のコードでは、不確定は入力ファイルの読み込み時に、マルチマップとstringとequal_range()関数を使っています。
+
−
 
+
−
<syntaxhighlight lang="cpp">
+
−
  multimap<string,pair<int,int> > input_config;
+
−
 
+
−
  // read configuration from file "input.conf" to input_config
+
−
  readConfigFile( input_config, "input.conf" );
+
−
 
+
−
  pair<multimap<string,pair<int,int> >::iterator,multimap<string,pair<int,int> >::iterator> ii;
+
−
  multimap<string,pair<int,int> >::iterator i;
+
−
 
+
−
  ii = input_config.equal_range("key");        // keyboard key-bindings
+
−
  // we can iterate over a range just like with begin() and end() 
+
−
  for( i = ii.first; i != ii.second; ++i ) {
+
−
    // add a key binding with this key and output
+
−
    bindkey(i->second.first, i->second.second);
+
−
  }
+
−
 
+
−
  ii = input_config.equal_range("joyb");        // joystick button key-bindings
+
−
  for( i = ii.first; i != ii.second; ++i ) {
+
−
    // add a key binding with this joystick button and output
+
−
    bindjoyb(i->second.first, i->second.second);
+
−
  }
+
−
 
+
−
</syntaxhighlight>
+

2018年3月16日 (金) 06:27時点における最新版

[edit template]
 
C++
 
コンテナライブラリ
 
std::multimap
メンバ関数
イテレータ
(C++11)
(C++11)
(C++11)
(C++11)
容量
変更
(C++11)
(C++11)
(C++17)
(C++17)
検索
(C++20)
multimap::equal_range
観察
非メンバ関数
(C++20)
(C++20未満)(C++20未満)(C++20未満)(C++20未満)(C++20未満)(C++20)
推定ガイド(C++17)
 
std::pair<iterator,iterator> equal_range( const Key& key );
 (1)
std::pair<const_iterator,const_iterator> equal_range( const Key& key ) const;
 (2)
template< class K >
std::pair<iterator,iterator> equal_range( const K& x );
 (3) (C++14以上)
template< class K >
std::pair<const_iterator,const_iterator> equal_range( const K& x ) const;
 (4) (C++14以上)

コンテナ内の指定されたキーを持つすべての要素を含む範囲を返します。 範囲は2つのイテレータで示されます。 ひとつは key より小さくない最初の要素を指し、もうひとつは key より大きい最初の要素を指します。 代わりに lower_bound() を使用して最初の要素を取得し、 upper_bound() を使用して2番目の要素を取得することもできます。

1,2) キーと key を比較します。
3,4) キーと値 x を比較します。 このオーバーロードは、修飾識別子 Compare::is_transparent が有効で、型を表す場合にのみ、オーバーロード解決に参加します。 これにより Key を構築せずにこの関数を呼ぶことができます。
This section is incomplete
Reason: explain better

目次

[編集] 引数

key - 要素と比較するキーの値
x - Key と比較可能な代わりの値

[編集] 戻り値

所望の範囲を示す1組のイテレータを持つ std::pair。 その最初の要素は key より小さくない最初の要素を指し、その2番目の要素は key より大きい最初の要素を指します。

key より小さくない要素がない場合は、最初の要素として終端イテレータ (end() を参照) が返されます。 同様に、 key より大きい要素がない場合は、2番目の要素として終端イテレータが返されます。

emplace およびヒントなしの insert は常に upper bound に挿入するため、ヒント付きの insert または emplace_hint を使用して異なる位置に要素を挿入していなければ、 equal range 内の同等な要素の順序は挿入順になります。 (C++11以上)

[編集] 計算量

コンテナのサイズの対数。

[編集] 例

Run this code
#include <iostream>
#include <map>
 
int main()
{
    std::multimap<int, char> dict {
        {1, 'A'},
        {2, 'B'},
        {2, 'C'},
        {2, 'D'},
        {4, 'E'},
        {3, 'F'}
    };
 
    auto range = dict.equal_range(2);
 
    for (auto i = range.first; i != range.second; ++i)
    {
        std::cout << i->first << ": " << i->second << '\n';
    }
}

出力: 

2: B
2: C
2: D

[編集] 関連項目

 指定されたキーを持つ要素を探します
(パブリックメンバ関数) [edit]
指定されたキーより大きい最初の要素を指すイテレータを返します
(パブリックメンバ関数) [edit]
指定されたキーより小さくない最初の要素を指すイテレータを返します
(パブリックメンバ関数) [edit]
「https://ja.cppreference.com/mwiki/index.php?title=cpp/container/multimap/equal_range&oldid=34459」から取得