list::splice (STL/CLR)

發行項
06/10/2015

節點之間的 Restitch 連結。

    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);

參數

首先
不規則範圍開頭。
last
不規則範圍結尾。
right
不規則從容器。
where
只要在先前的容器。

備註

第 10% 成員函式在 where上的對受控制序列的順序由 right 在這個項目之前。從 right中移除所有項目。(%right 必須不等於 this)。您會用它來接合任何一個清單到另一個。

第二 + 成成員函式移除項目指向 first 位在順序由 right 並將這個項目之前在受控制序列中所指向的 where。如果 ( where==first||where== ++first，不會發生變更)。您會用它來接合一份清單中的單一項目到另一個。

第三 + 成成員函式在 where上的對受控制序列插入 [指定的子first,的last從) 順序由 right 在這個項目之前。它也會從原始的子範圍順序由 right。(如果 right為==則為this，範圍為 [first,last) 不能包含項目指向 where)。您會用它來接合零個或多個項目 subsequence 從一個清單的到另一個中。

範例

// 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); 
    }