Syntax:

    #include <map>
    iterator insert( iterator pos, const T& val );
    iterator insert( const T& val );
    void insert( input_iterator start, input_iterator end );

insert()関数は、次の動作をします。

• “pos”で指定された要素の後に、値を挿入します(挿入時には、”pos”が使われますが、すぐにマップは並び替えられます)。挿入した要素を指すイテレータを返します。
• 値をマルチマップに挿入すると、その要素を指すイテレータが返されます。
• イテレータの指す”start”から”end”までの要素を挿入します。

たとえば、次のコードでは、insert()関数を使い、<name, ID>の組をもつ社員のマルチマップを作っています。

    multimap<string,int> m;
 
    int employeeID = 0;
    m.insert( pair<string,int>("Bob Smith",employeeID++) );
    m.insert( pair<string,int>("Bob Thompson",employeeID++) );
    m.insert( pair<string,int>("Bob Smithey",employeeID++) );
    m.insert( pair<string,int>("Bob Smith",employeeID++) );
 
    cout << "Number of employees named 'Bob Smith': " << m.count("Bob Smith") << endl;
    cout << "Number of employees named 'Bob Thompson': " << m.count("Bob Thompson") << endl;
    cout << "Number of employees named 'Bob Smithey': " << m.count("Bob Smithey") << endl;
 
    cout << "Employee list: " << endl;
    for( multimap<string, int>::iterator iter = m.begin(); iter != m.end(); ++iter ) {
      cout << " Name: " << iter->first << ", ID #" << iter->second << endl;
    }

実行時に、上記のコードは、次の出力を生成します。

  Number of employees named 'Bob Smith': 2
  Number of employees named 'Bob Thompson': 1
  Number of employees named 'Bob Smithey': 1
  Employee list:
   Name: Bob Smith, ID #0
   Name: Bob Smith, ID #3
   Name: Bob Smithey, ID #2
   Name: Bob Thompson, ID #1