vector::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
počet
Počet prvků, které chcete vložit.první
Začátek oblasti vložení.poslední
Konec rozsahu vložit.pravý
Výčet vložit.Val
Hodnota prvku vložit.kde
Kde v kontejneru vložit před.
Poznámky
Každý člen funkce vloží prvek odkazuje před where řízený sekvence určený posloupnost zbývající operandy.
První členské funkce vloží prvek s hodnotou val a vrátí iterace, který určuje nově vloženého prvku.Pomocí vložit prvek před místo určené iterace.
Druhý členské funkce vloží opakování count prvky hodnotu val.Použijte 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).Pomocí vložit zkopírovaný z jiného pořadí nula nebo více sousedících prvků.
Čtvrtý členské funkce vloží pořadí určené right.Použijte k vložení Sled popsaný čítač výčtu.
Při vkládání jeden prvek je počet kopií prvek lineární v počtu prvků mezi kurzorem a bližšího konci sekvence.(Při vložení jednoho nebo více prvků na některém konci sekvence, žádné kopie prvku nastat.) Pokud InIt je vstupní iterace třetí členské funkce účinně provádí jediný kurzor pro každý prvek v pořadí.Jinak při vkládání N prvky, počet kopií prvek je v lineární N plus počet prvků mezi kurzorem a bližšího konci sekvence.
Příklad
// cliext_vector_insert.cpp
// compile with: /clr
#include <cliext/vector>
int main()
{
cliext::vector<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::vector<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::vector<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();
return (0);
}
Požadavky
Záhlaví: < cliext/vector >
Obor názvů: cliext