C++ 映射库 - insert() 函数

描述

C++ 函数std::multimap::insert() 通过在 multimap 中插入新元素来扩展容器。此函数使容器大小增加一。

声明

以下是来自 std::map 头文件的 std::multimap::insert() 函数声明。

C++98

iterator insert (iterator position, const value_type& val);

C++11

iterator insert (const_iterator position, const value_type& val);

参数

• position − 插入元素的位置提示。

• val − 要插入的值。

返回值

返回指向新插入元素的迭代器。

异常

如果抛出异常，则对容器没有影响。

时间复杂度

对数，即 O(log n)

示例

以下示例显示了 std::multimap::insert() 函数的使用。

#include <iostream>
#include <map>

using namespace std;

int main(void) {
   /* Multimap with duplicates */
   multimap<char, int> m {
            {'a', 1},
            {'a', 2},
            {'b', 3},
            {'c', 4},
         };

   auto pos = m.insert(m.begin(), pair<char, int>('a', 0));

   cout << "After inserting new element iterator points to" << endl;
   cout << pos->first << " = " << pos->second << endl;

   return 0;
}

让我们编译并运行上面的程序，这将产生以下结果：

After inserting new element iterator points to
a = 0