list::splice (STL/CLR)

Článek
06/10/2015

Restitch vazeb mezi uzly.

    void splice(iterator where, list<Value>% right);
    void splice(iterator where, list<Value>% right,
        iterator first);
    void splice(iterator where, list<Value>% right,
        iterator first, iterator last);

Parametry

první
Začátek rozsahu splice.
poslední
Konec rozsahu splice.
pravý
Splice z kontejneru.
kde
Kde v kontejneru před splice.

Poznámky

První členské funkce vloží sekvence řízena right před prvek v kontrolovaných sekvenci ukazující na where.Odebere také všechny prvky z right. (%right must not equal this.) Použít pro všechny z jednoho seznamu do jiného splice.

Druhý člen funkce odstraní prvek odkazuje first v pořadí řídí right a vloží před řízené postupně prvek odkazuje je where. (If where == first || where == ++first, no change occurs.) Použijte na splice jeden prvek z jednoho seznamu do jiného.

Třetí členská funkce vloží Podrozsah určený [first, last) z řady řízena right před prvek v kontrolovaných sekvenci ukazující na where.Odebere také původní Podrozsah ze sekvence řízena right. (If right == this, the range [first, last) must not include the element pointed to by where.) Použijte na splice subsequence nula nebo více prvků z jednoho seznamu do jiného.

Příklad

// cliext_list_splice.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(); 
 
// splice to a new list 
    cliext::list<wchar_t> c2; 
    c2.splice(c2.begin(), c1); 
    System::Console::WriteLine("c1.size() = {0}", c1.size()); 
    for each (wchar_t elem in c2) 
        System::Console::Write(" {0}", elem); 
    System::Console::WriteLine(); 
 
// return one element 
    c1.splice(c1.end(), c2, c2.begin()); 
    for each (wchar_t elem in c1) 
        System::Console::Write(" {0}", elem); 
    System::Console::WriteLine(); 
 
    for each (wchar_t elem in c2) 
        System::Console::Write(" {0}", elem); 
    System::Console::WriteLine(); 
 
// return remaining elements 
    c1.splice(c1.begin(), c2, c2.begin(), c2.end()); 
    for each (wchar_t elem in c1) 
        System::Console::Write(" {0}", elem); 
    System::Console::WriteLine(); 
    System::Console::WriteLine("c2.size() = {0}", c2.size()); 
    return (0); 
    }