std::flat_multimap<Key,T,Compare,KeyContainer,MappedContainer>::equal_range

 

C++

コンパイラサポート

フリースタンディングとホスト

言語

標準ライブラリ

標準ライブラリヘッダー

名前付き要件

機能テストマクロ (C++20)

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

メモリ管理ライブラリ

メタプログラミングライブラリ (C++11)

汎用ユーティリティライブラリ

コンテナライブラリ

イテレータライブラリ

Rangesライブラリ (C++20)

アルゴリズムライブラリ

文字列ライブラリ

テキスト処理ライブラリ

数値ライブラリ

日付と時刻ライブラリ

入出力ライブラリ

ファイルシステムライブラリ (C++17)

並行サポートライブラリ (C++11)

実行制御ライブラリ (C++26)

Technical specifications (技術仕様)

シンボルインデックス

外部ライブラリ

 

コンテナライブラリ

シーケンス

array (C++11)

vector

vector<bool>

inplace_vector (C++26)

hive (C++26)

deque

forward_list (C++11)

list

連想

set

multiset

map

multimap

非順序連想

unordered_set (C++11)

unordered_multiset (C++11)

unordered_map (C++11)

unordered_multimap (C++11)

アダプタ

stack

queue

priority_queue

flat_set (C++23)

flat_multiset (C++23)

flat_map (C++23)

flat_multimap (C++23)

表示

span (C++20)

mdspan (C++23)

表

イテレータの無効化

メンバ関数テーブル

非メンバ関数テーブル

 

std::flat_multimap

メンバ型

メンバ関数

flat_multimap::flat_multimap    flat_multimap::operator= 変更 flat_multimap::clear flat_multimap::erase flat_multimap::swap flat_multimap::extract flat_multimap::replace flat_multimap::insert flat_multimap::insert_range flat_multimap::emplace flat_multimap::emplace_hint 検索 flat_multimap::count flat_multimap::find flat_multimap::contains flat_multimap::equal_range flat_multimap::lower_bound flat_multimap::upper_bound イテレータ flat_multimap::beginflat_multimap::cbegin flat_multimap::endflat_multimap::cend flat_multimap::rbeginflat_multimap::crbegin flat_multimap::rendflat_multimap::crend 容量 flat_multimap::size flat_multimap::max_size flat_multimap::empty 監視 flat_multimap::key_comp flat_multimap::keys flat_multimap::value_comp flat_multimap::values

非メンバ関数

swap(std::flat_multimap) erase_if(std::flat_multimap)     operator==operator<=>

ヘルパークラス

uses_allocator<std::flat_multimap>

タグ

sorted_equivalent          sorted_equivalent_t

推論補助

 

std::pair<iterator, iterator> equal_range( const Key& key );	(1)	(C++23から)
std::pair<const_iterator, const_iterator> equal_range( const Key& key ) const;	(2)	(C++23から)
template< class K > std::pair<iterator, iterator> equal_range( const K& x );	(3)	(C++23から)
template< class K > std::pair<const_iterator, const_iterator> equal_range( const K& x ) const;	(4)	(C++23から)

指定されたキーを持つコンテナ内のすべての要素を含む範囲を返します。この範囲は、2つのイテレータによって定義されます。1つは key に それ以下 である最初の要素を指し、もう1つは key より 大きい 最初の要素を指します。あるいは、最初のイテレータは lower_bound() で取得でき、2番目のイテレータは upper_bound() で取得できます。

1,2) キーと key を比較します。

3,4) キーと値 x を比較します。このオーバーロードは、修飾子 Compare::is_transparent が有効で型を表す場合にのみオーバーロード解決に参加します。これにより、Key のインスタンスを構築せずにこの関数を呼び出すことができます。

パラメータ

key	-	比較対象の値
x	-	Key と比較可能な代替値

戻り値

std::pair。目的の範囲を定義するイテレータのペアを含みます。最初のイテレータは key に それ以下 である最初の要素を指し、2番目のイテレータは key より 大きい 最初の要素を指します。

key に それ以下 である要素がない場合、最初の要素として終了後 (past-the-end) ( end() 参照) のイテレータが返されます。同様に、 key より 大きい 要素がない場合、2番目の要素として終了後 (past-the-end) のイテレータが返されます。

emplace およびヒントなしの insert は常に上限に挿入するため、等価な要素のイコールレンジ内の順序は、ヒント付きの insert または emplace_hint を使用して要素が異なる位置に挿入された場合を除き、挿入順になります。

計算量

コンテナのサイズに対して対数時間。

例

このコードを実行

#include <iostream>
#include <flat_map>
 
template<typename I>
void print_equal_range(I first, I lb, I ub, I last)
{
    for (I i{first}; i != lb; ++i)
        std::cout << *i << ' ';
    std::cout << "[ ";
 
    for (I i{lb}; i != ub; ++i)
        std::cout << *i << ' ';
    std::cout << ") ";
 
    for (I i{ub}; i != last; ++i)
        std::cout << *i << ' ';
    std::cout << '\n';
}
 
int main()
{
    std::flat_multimap<int> c{4, 3, 2, 1, 3, 3};
    std::cout << "c = ";
    print_equal_range(begin(c), begin(c), end(c), end(c));
    for (int key{}; key != 6; ++key)
    {
        std::cout << "key = " << key << "; equal range = ";
        const auto [lb, ub] = c.equal_range(key);
        print_equal_range(begin(c), lb, ub, end(c));
    }
}

出力

c = [ 1 2 3 3 3 4 )
key = 0; equal range = [ ) 1 2 3 3 3 4
key = 1; equal range = [ 1 ) 2 3 3 3 4
key = 2; equal range = 1 [ 2 ) 3 3 3 4
key = 3; equal range = 1 2 [ 3 3 3 ) 4
key = 4; equal range = 1 2 3 3 3 [ 4 )
key = 5; equal range = 1 2 3 3 3 4 [ )

関連項目

find	特定のキーを持つ要素を検索する (公開メンバ関数)
contains	コンテナが特定のキーを持つ要素を含むか確認する (公開メンバ関数)
count	特定のキーに一致する要素の数を返す (公開メンバ関数)
upper_bound	指定されたキーより大きい最初の要素へのイテレータを返す (公開メンバ関数)
lower_bound	指定されたキーより小さくない最初の要素へのイテレータを返す (公開メンバ関数)
equal_range	特定のキーに一致する要素の範囲を返す (関数テンプレート)