hash_multiset::insert

注意事項
這個 API 已經過時。這個選項是 unordered_multiset Class。

插入項目或某個範圍的 hash_multiset。

iterator insert(
   const value_type& _Val
);
iterator insert(
   iterator _Where,
   const value_type& _Val
);
template<class InputIterator>
   void insert(
      InputIterator _First,
      InputIterator _Last
   );
template<class ValTy>
    iterator insert(
        ValTy&& _Val
);
template<class ValTy>
    iterator insert(
        const_iterator _Where,
        ValTy&& _Val
);

參數

參數	描述
_Val	要插入之項目的值。hash_multiset，除非 hash_multiset，一般而言，已經包含該項目或索引鍵相等的已排序的項目。
_Where	這個位置開始搜尋正確問題的外掛程式。 (在被插入到舊的常數時間可能發生，而不是對的時間，則為，如果插入點後面緊接著 _Where)。
_First	從 hash_multiset 將複製的第一個項目的位置。
_Last	位置是從 hash_multiset 將複製的最後一個項目之外。

傳回值

前兩個 insert 成員函式傳回指向位置插入新項目的 Iterator。

最後兩個 insert 成員函式一般作業的前兩個相同，不過，它們移動建構插入的值。

備註

如果插入點後面緊接著 _Where，插入提示版本的已轉換舊的常數時間可能發生，而不是對的時間。

第三 + 成成員函式插入項目值序列 hash_multiset 與 Iterator 定址每個項目對應到範圍 [_First， _Last) 中指定的 hash_multiset。

範例

// hash_multiset_insert.cpp
// compile with: /EHsc
#include <hash_set>
#include <iostream>

int main( )
{
   using namespace std;
   using namespace stdext;
   hash_multiset <int>::iterator hms1_pIter, hms2_pIter;

   hash_multiset <int, hash_compare <int, less<int> > > hms1, hms2;
   hms1.insert( 10 );
   hms1.insert( 20 );
   hms1.insert( 30 );
   hms1.insert( 40 );

   cout << "The original hms1 =";
   for ( hms1_pIter = hms1.begin( ); hms1_pIter != hms1.end( );
         hms1_pIter++ )
      cout << " " << *hms1_pIter;
   cout << "." << endl;


   hms1.insert( 20 );
   hms1.insert( --hms1.end( ), 50 );

   cout << "After the insertions, hms1 =";
   for ( hms1_pIter = hms1.begin( ); hms1_pIter != hms1.end( );
         hms1_pIter++ )
      cout << " " << *hms1_pIter;
   cout << "." << endl;

   hms2.insert( 100 );
   hms2.insert( ++hms1.begin( ), --hms1.end( ) );

   cout << "hms2 =";
   for ( hms2_pIter = hms2.begin( ); hms2_pIter != hms2.end( );
         hms2_pIter++ )
      cout << " " << *hms2_pIter;
   cout << "." << endl;

   // move construct an element
   hash_multiset<string> hms3, hms4;
   string str1("a"), str2("b");

   hms3.insert(move(str1));
   cout << "After the move insertion, hms3 contains "
      << *hms3.begin() << "." << endl;

   hms4.insert(hms4.begin(), move(str1));
   cout << "After the move insertion, hms4 contains "
      << *hms4.begin() << "." << endl;
}

需求

標題: <hash_set>

命名空間: stdext

請參閱

參考

hash_multiset Class

標準樣板程式庫