list::insert (STL/CLR)
Přidá prvky na určené pozici.
iterator insert(iterator where, value_type val);
void insert(iterator where, size_type count, value_type val);
template<typename InIt>
void insert(iterator where, InIt first, InIt last);
void insert(iterator where,
System::Collections::Generic::IEnumerable<Value>^ right);
Parametry
count
Počet prvků, které chcete vložit.první
Začátek rozsahu vložit.poslední
Konec rozsahu vložit.pravý
Výčet, který chcete vložit.Val
Hodnota prvek, který chcete vložit.kde
Kde v kontejneru, který má být vložen před.
Poznámky
Každý člen funkce vloží před prvek odkazuje where v řízené sekvenci posloupnost určený zbývající operandy.
První členské funkce vloží prvek s hodnotou val a vrátí iterace, označí nově vloženého prvku.Slouží k vložení jednoho prvku před místem určeným iterace.
Druhý člen funkce vloží opakování count prvky hodnoty val.Slouží k vložení nula nebo více souvislých prvky, které jsou všechny kopie stejné hodnoty.
If InIt is an integer type, the third member function behaves the same as insert(where, (size_type)first, (value_type)last).Otherwise, it inserts the sequence [first, last).Slouží k vložení nula nebo více sousedních prvků zkopírována z jiné řady.
Čtvrtá členská funkce vloží určené pořadí right.Pomocí sekvence popsané enumerátor vložit.
Při vkládání jednotlivých elementů, počet kopií prvku je lineární v počtu prvků mezi kurzorem a bližšího konci sekvence. (Při vložení jednoho nebo více prvků na každém konci sekvence, žádné kopie prvku nastat.) Pokud InIt je iterátor vstupní třetí členská funkce účinně provádí jeden kurzor pro každý prvek v pořadí.Jinak při vkládání N prvky, počet kopií prvku je lineární v N plus počet prvků mezi kurzorem a bližšího konci sekvence.
Příklad
// cliext_list_insert.cpp
// compile with: /clr
#include <cliext/list>
int main()
{
cliext::list<wchar_t> c1;
c1.push_back(L'a');
c1.push_back(L'b');
c1.push_back(L'c');
// display initial contents " a b c"
for each (wchar_t elem in c1)
System::Console::Write(" {0}", elem);
System::Console::WriteLine();
// insert a single value using iterator
cliext::list<wchar_t>::iterator it = c1.begin();
System::Console::WriteLine("insert(begin()+1, L'x') = {0}",
*c1.insert(++it, L'x'));
for each (wchar_t elem in c1)
System::Console::Write(" {0}", elem);
System::Console::WriteLine();
// insert a repetition of values
cliext::list<wchar_t> c2;
c2.insert(c2.begin(), 2, L'y');
for each (wchar_t elem in c2)
System::Console::Write(" {0}", elem);
System::Console::WriteLine();
// insert an iterator range
it = c1.end();
c2.insert(c2.end(), c1.begin(), --it);
for each (wchar_t elem in c2)
System::Console::Write(" {0}", elem);
System::Console::WriteLine();
// insert an enumeration
c2.insert(c2.begin(), // NOTE: cast is not needed
(System::Collections::Generic::IEnumerable<wchar_t>^)%c1);
for each (wchar_t elem in c2)
System::Console::Write(" {0}", elem);
System::Console::WriteLine();
// insert a single value using index
it = c2.begin();
++it, ++it, ++it;
c2.insert(it, L'z');
for each (wchar_t elem in c2)
System::Console::Write(" {0}", elem);
System::Console::WriteLine();
return (0);
}
Požadavky
Záhlaví:<cliext/seznam>
Obor názvů: cliext