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

 

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

推論補助

 

iterator erase( iterator position );	(1)	(C++23から)
iterator erase( const_iterator pos );	(2)	(C++23から)
iterator erase( const_iterator first, const_iterator last );	(3)	(C++23から)
size_type erase( const Key& key );	(4)	(C++23から)
template< class K > size_type erase( K&& x );	(5)	(C++23から)

コンテナから指定された要素を削除します。残りの同値な要素の順序は保持されます。

1,2) pos の位置にある要素を削除します。

3) *this内の有効な範囲である範囲[first, last)の要素を削除します。

4) key と同値なキーを持つすべての要素を削除します。

5) 値 x と比較して同値であるキーを持つすべての要素を削除します。このオーバーロードは、修飾子付きID Compare::is_transparent が有効で型を示す場合、かつ iterator も const_iterator も K から暗黙的に変換可能でない場合にのみ、オーバーロード解決に参加します。これにより、Key のインスタンスを構築せずにこの関数を呼び出すことができます。

イテレータ pos は有効で逆参照可能である必要があります。したがって、end() イテレータ（有効ですが逆参照可能ではありません）は pos の値として使用することはできません。

パラメータ

pos	-	削除する要素へのイテレータ
first, last	-	削除する要素の範囲を定義するイテレータのペア
key	-	削除する要素のキー値
x	-	削除する要素を示すキーと透明に比較できる任意の型の値

戻り値

1-3) 削除された最後の要素の後のイテレータ。

4) 削除された要素の数。

5) 削除された要素の数。

例外

1-3) 例外はスローされません。

4,5) Compare オブジェクトによってスローされる可能性のある例外。

計算量

基盤となるコンテナに依存します。通常は線形時間です。

例

このコードを実行

#include <flat_map>
#include <iostream>
 
int main()
{
    std::flat_multimap<int, std::string> c =
    {
        {1, "one"}, {2, "two"}, {3, "three"},
        {4, "four"}, {5, "five"}, {6, "six"}
    };
 
    // erase all odd numbers from c
    for (auto it = c.begin(); it != c.end();)
    {
        if (it->first % 2 != 0)
            it = c.erase(it);
        else
            ++it;
    }
 
    for (auto& p : c)
        std::cout << p.second << ' ';
    std::cout << '\n';
}

出力

two four six

関連項目

clear

内容をクリアする (公開メンバ関数)