unordered_multiset::insert

新增項目。

iterator insert(const value_type& val);
iterator insert(iterator where, const value_type& val);
template<class InIt>
    void insert(InIt first, InIt last);
template<class ValTy>
    iterator insert(ValTy&& val);
template<class ValTy>
    iterator insert(const_iterator where, ValTy&& val);

參數

參數	描述
InIt	Iterator 型別。
ValTy	在就地的建構函式的引數型別。
first	若要插入的範圍的開頭。
last	若要插入的範圍的結尾。
val	若要插入的值。
where	若要插入 (只有提示) 的容器中的位置。

備註

第一個成員函式將項目val在受控制序列，則會傳回 iterator，指派插入的項目。 第二個成員函式會傳回insert(val)、 使用where為起始的位置中搜尋插入點的受控制序列。 (插入可能可能速度會較快，如果插入點立即前面或後面是where。)

第三個成員函式每個插入的項目值的順序where範圍內[first, last)，藉由呼叫insert(*where)。

最後兩個成員函式的行為與前兩個，除了的相同val用來建構插入的值。

如果單一元素的插入動作期間擲回例外狀況時，就會留在容器不變，和例外狀況重新擲回。 如果插入多個項目時擲回例外狀況時，容器會處於穩定但未指定的狀態，並會重新擲回例外狀況。

範例

// std_tr1__unordered_set__unordered_multiset_insert.cpp 
// compile with: /EHsc 
#include <unordered_set> 
#include <iostream>
#include <string> 
 
typedef std::unordered_multiset<char> Myset; 
int main() 
    { 
    Myset c1; 
 
    c1.insert('a'); 
    c1.insert('b'); 
    c1.insert('c'); 
 
// display contents " [c] [b] [a]" 
    for (Myset::const_iterator it = c1.begin(); 
        it != c1.end(); ++it) 
        std::cout << " [" << *it << "]"; 
    std::cout << std::endl; 
 
// insert with hint and reinspect 
    Myset::iterator it2 = c1.insert(c1.begin(), 'd'); 
    for (Myset::const_iterator it = c1.begin(); 
        it != c1.end(); ++it) 
        std::cout << " [" << *it << "]"; 
    std::cout << std::endl; 
 
// insert range and inspect 
    Myset c2; 
 
    c2.insert(c1.begin(), c1.end()); 
    for (Myset::const_iterator it = c2.begin(); 
        it != c2.end(); ++it) 
        std::cout << " [" << *it << "]"; 
    std::cout << std::endl; 
 
// insert new and duplicate, and reinspect 
    c1.insert('e'); 
    c1.insert('a'); 
    for (Myset::const_iterator it = c1.begin(); 
        it != c1.end(); ++it) 
        std::cout << " [" << *it << "]"; 
    std::cout << std::endl; 
 
// The templatized versions move constructing elements
    unordered_multiset< string> c3, c4;
    string str1("a"), str2("b");

    c3.insert(move(is1));
    cout << "After the move insertion, c3 contains: "
        << *c3.begin() << endl;

    c4.insert(c4.begin(), move(is2));
    cout << "After the move insertion, c4 contains: "
        << *c4.begin() << endl;

    return (0); 
    } 
 

需求

標頭: <unordered_set>

Namespace: 標準

請參閱

參考

<unordered_set>

unordered_multiset Class

其他資源

<unordered_set> 成員