multiset::insert
Inserire un elemento o un intervallo di elementi in un multi-insieme.
iterator insert(
const value_type& _Val
);
iterator insert(
const_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
);
Parametri
Parametro |
Descrizione |
_Val |
Il valore di un elemento da inserire nel multi-insieme a meno che il multi-insieme già contenere più generale tale elemento, o, un elemento il cui la chiave equivalente è ordinata. |
_Where |
Il posto per avviare ricerca il punto corretto di inserimento.L'inserimento può verificarsi nel tempo costante ammortizzato invece di tempo logaritmico, se il punto di inserimento immediatamente successivo a _Where. |
_First |
La posizione del primo elemento da un multi-insieme. |
_Last |
La posizione solo oltre l'ultimo elemento da un multi-insieme. |
Valore restituito
Le funzioni membro insert restituisce un iteratore che indica la posizione in cui il nuovo elemento è stato immesso nel multi-insieme.
Note
La terza funzione membro inserire la sequenza di valori degli elementi in un multi-insieme corrispondente a ogni elemento indirizzato mediante un iteratore nell'intervallo [_First, _Last) di un multi-insieme specificato.
Le ultime due funzioni membro si comportano allo stesso modo dei primi due, ma val viene utilizzato per costruire il valore immesso.
Esempio
// multiset_insert.cpp
// compile with: /EHsc
#include <set>
#include <iostream>
#include <string>
int main( )
{
using namespace std;
multiset <int>::iterator ms1_pIter, ms2_pIter;
multiset <int, less<int> > ms1, ms2;
ms1.insert( 10 );
ms1.insert( 20 );
ms1.insert( 30 );
ms1.insert( 40 );
cout << "The original ms1 =";
for ( ms1_pIter = ms1.begin( ); ms1_pIter != ms1.end( ); ms1_pIter++ )
cout << " " << *ms1_pIter;
cout << "." << endl;
ms1.insert( 20 );
ms1.insert( --ms1.end( ), 50 );
cout << "After the insertions, ms1 =";
for ( ms1_pIter = ms1.begin( ); ms1_pIter != ms1.end( ); ms1_pIter++ )
cout << " " << *ms1_pIter;
cout << "." << endl;
ms2.insert( 100 );
ms2.insert( ++ms1.begin( ), --ms1.end( ) );
cout << "ms2 =";
for ( ms2_pIter = ms2.begin( ); ms2_pIter != ms2.end( ); ms2_pIter++ )
cout << " " << *ms2_pIter;
cout << "." << endl;
// Construct by moving
multiset<string> ms3, ms4;
string str1("a"), str2("b");
ms3.insert(move(str1));
cout << "After the move insertion, ms3 contains: "
<< *ms3.begin() << endl;
ms4.insert(ms4.begin(), move(str2));
cout << "After the move insertion, ms4 contains: "
<< *ms4.begin() << endl;
}
Requisiti
intestazione: <set>
Spazio dei nomi: deviazione standard