set::emplace
Inserisce un elemento costruito in locale (non viene effettuata alcuna operazione di copia o di spostamento).
template<class... Args>
pair<iterator, bool> emplace(
Args&&... args
);
Parametri
Parametro |
Descrizione |
args |
Gli argomenti inoltrati per costruire un elemento da inserire nel set a meno che questo già contenga un elemento il cui valore è equivalentemente. |
Valore restituito
Una coppia il cui il componente booleano restituisce true se è stato eseguito un inserimento, e false se la mappa già contiene un elemento il cui valore è equivalentemente ordinato. Il componente di iteratore della coppia dei valori resituiti restituisce l'indirizzo dove è stato inserito un nuovo elemento (se il componente booleano è true) o l'indirizzo dove si trova l'elemento già esistente (se il componente booleano è false).
Note
Nessun iteratore o puntatore, viene invalidato da questa funzione.
Durante il collocamento, se viene generata un'eccezione, lo stato del contenitore non viene modificato.
Esempio
// set_emplace.cpp
// compile with: /EHsc
#include <set>
#include <string>
#include <iostream>
using namespace std;
template <typename S> void print(const S& s) {
cout << s.size() << " elements: ";
for (const auto& p : s) {
cout << "(" << p << ") ";
}
cout << endl;
}
int main()
{
set<string> s1;
auto ret = s1.emplace("ten");
if (!ret.second){
cout << "Emplace failed, element with value \"ten\" already exists."
<< endl << " The existing element is (" << *ret.first << ")"
<< endl;
cout << "set not modified" << endl;
}
else{
cout << "set modified, now contains ";
print(s1);
}
cout << endl;
ret = s1.emplace("ten");
if (!ret.second){
cout << "Emplace failed, element with value \"ten\" already exists."
<< endl << " The existing element is (" << *ret.first << ")"
<< endl;
}
else{
cout << "set modified, now contains ";
print(s1);
}
cout << endl;
}
Output
set modified, now contains 1 elements: (ten)
Emplace failed, element with value "ten" already exists.
The existing element is (ten)
Requisiti
Intestazione: <set>
Spazio dei nomi: std