std::flat_multimap::emplace_hint

template <class... Args>
iterator emplace_hint(const_iterator hint, Args&&... args);

概要

要素が配置されるべき場所を示唆するパラメータ hint を使って、コンテナに新しい要素を挿入する。要素は直接構築される（コピーもムーブもされない）。要素のコンストラクタはこの関数に渡された引数と同じ引数で呼ばれる。

パラメータ

• hint : 新しい要素をどこへ挿入するかを示唆するために使われるイテレータ
• args... : 要素のコンストラクタへ転送される引数パック

戻り値

追加された要素を指すイテレータ。

計算量

一般にコンテナのサイズについて対数時間だが、新しい要素が hint の前に挿入された場合は償却定数時間。

例

#include <flat_map>
#include <iostream>

int main()
{
  std::flat_multimap<int, char> fm;

  fm.emplace(1, 'A');

  // キー2の要素が最後尾に追加されることが事前にわかっているので、fm.end()をヒントとして与える
  fm.emplace_hint(fm.end(), 2, 'B');

  for (const auto& [key, value] : fm) {
    std::cout << key << " : " << value << std::endl;
  }
}

#include <flat_map>

#include <iostream>

​

int main()

{

  std::flat_multimap<int, char> fm;

​

  fm.emplace(1, 'A');

​

  // キー2の要素が最後尾に追加されることが事前にわかっているので、fm.end()をヒントとして与える

  fm.emplace_hint(fm.end(), 2, 'B');

​

  for (const auto& [key, value] : fm) {

    std::cout << key << " : " << value << std::endl;

  }

}

​

出力

1 : A
2 : B

バージョン

言語

• C++23

処理系

• Clang: ??
• GCC: ??
• Visual C++: ??

関連項目