list (STL/CLR)

發行項
06/10/2015

樣板類別描述物件控制存取雙向項目的變更長度序列。您使用容器 list 處理項目序列做為節點雙向連結串列，每個儲存一個項目。

在如下解譯， GValue 相當於 Value ，除非後面是參考型別，在這種情況下，它是 Value^的情況下。

template<typename Value>
    ref class list
        :   public
        System::ICloneable,
        System::Collections::IEnumerable,
        System::Collections::ICollection,
        System::Collections::Generic::IEnumerable<GValue>,
        System::Collections::Generic::ICollection<GValue>,
        Microsoft::VisualC::StlClr::IList<GValue>
    { ..... };

參數

值
受控制序列中項目的型別。

成員

型別定義	說明
list::const_iterator (STL/CLR)	用於受控制序列的常數迭代器類型。
list::const_reference (STL/CLR)	項目的常數參考類型。
list::const_reverse_iterator (STL/CLR)	用於受控制序列的常數反向迭代器類型。
list::difference_type (STL/CLR)	兩個項目之間的帶正負號距離的類型。
list::generic_container (STL/CLR)	泛型介面的型別的容器。
list::generic_iterator (STL/CLR)	容器的泛型介面的迭代器的型別。
list::generic_reverse_iterator (STL/CLR)	容器的泛型介面的反向迭代器的型別。
list::generic_value (STL/CLR)	容器的泛型介面的元素的型別。
list::iterator (STL/CLR)	受控制序列中 iterator 的類型。
list::reference (STL/CLR)	項目的參考類型。
list::reverse_iterator (STL/CLR)	用於受控制序列的反向迭代器類型。
list::size_type (STL/CLR)	兩個項目之間的帶正負號距離的類型。
list::value_type (STL/CLR)	項目的類型。

成員函式	說明
list::assign (STL/CLR)	取代所有項目。
list::back (STL/CLR)	存取最後一個項目。
list::begin (STL/CLR)	指定受控制序列的開頭。
list::clear (STL/CLR)	移除所有項目。
list::empty (STL/CLR)	測試項目是否不存在。
list::end (STL/CLR)	指定受控制序列的結尾。
list::erase (STL/CLR)	移除指定位置的項目。
list::front (STL/CLR)	存取第一個項目。
list::insert (STL/CLR)	將項目加至指定的位置。
list::list (STL/CLR)	建構一個容器物件。
list::merge (STL/CLR)	合併兩個已排序的受控制序列。
list::pop_back (STL/CLR)	移除最後一個項目。
list::pop_front (STL/CLR)	移除第一個項目。
list::push_back (STL/CLR)	加入新的最後一個元素。
list::push_front (STL/CLR)	加入新的第一個項目。
list::rbegin (STL/CLR)	指定已還原的受控制序列開頭。
list::remove (STL/CLR)	移除具有指定的值的項目。
list::remove_if (STL/CLR)	移除通過指定測試的項目。
list::rend (STL/CLR)	指定已還原的受控制序列結尾。
list::resize (STL/CLR)	變更項目的數目。
list::reverse (STL/CLR)	反轉受控制序列。
list::size (STL/CLR)	計數項目的數目。
list::sort (STL/CLR)	排序受控制序列。
list::splice (STL/CLR)	Restitches 節點之間的連結。
list::swap (STL/CLR)	交換兩個容器的內容。
list::to_array (STL/CLR)	複製受控制序列到新陣列。
list::unique (STL/CLR)	移除通過指定測試的相鄰項目。

屬性	說明
list::back_item (STL/CLR)	存取最後一個項目。
list::front_item (STL/CLR)	存取第一個項目。

運算子	說明
list::operator= (STL/CLR)	取代受控制序列。
operator!= (list) (STL/CLR)	判斷 list 物件是否不等於另一個 list 物件。
operator< (list) (STL/CLR)	判斷 list 物件是否小於另一個 list 物件。
operator<= (list) (STL/CLR)	判斷 list 物件是否小於或等於另外一個 list 物件。
operator== (list) (STL/CLR)	判斷 list 物件是否等於另一個 list 物件。
operator> (list) (STL/CLR)	判斷 list 物件是否大於另一個 list 物件。
operator>= (list) (STL/CLR)	判斷 list 物件是否大於或等於另外一個 list 物件。

介面

介面	說明
ICloneable	重複物件。
IEnumerable	序列傳遞項目。
ICollection	維護項目的群組。
IEnumerable	序列傳遞型別項目。
ICollection	維護型別項目的群組。
IList<Value>	維護泛型容器。

備註

物件配置和未使用的記憶體區域的控制項會以個別節點在雙向連結串列的序列。它可以用修改節點之間的連結的方式重新排列項目，絕不會透過複製的節點內容到另一個。這表示您可以自由地插入和移除項目，而不會干擾其他項目。因此，清單是類別 queue (STL/CLR) 或樣板類別的 stack (STL/CLR) 的基礎容器候選樣板。

list 物件支援雙向迭代器，這表示您可以逐步執行至指定的相鄰項目的迭代器在受控制序列的項目。特殊前端節點對應於 list::end (STL/CLR)所傳回的 Iterator()。如果您以這個 Iterator 到達受控制序列的最後一個項目。您可以增加清單迭代器以到達前端節點，因此，它與 end()會比較是否相等。但是，您無法取值 end()所傳回的 Iterator。

請注意您無法直接參考指定的清單元素其數值位置--該要求隨機存取 Iterator。因此清單是 not 能用以作為 priority_queue (STL/CLR)的基礎容器樣板類別。

清單迭代器中儲存關聯的清單節點的控制代碼，接著儲存的控制代碼關聯的容器。您只能使用 Iterator 與其關聯的容器物件。只要其關聯的清單節點與某一個清單相關連，清單迭代器保持有效。而且，有效 Iterator dereferencable--您可以使用它所指派它存取或修改項目的值--只要不等於 end()。

清除或移除元素呼叫它的儲存值的解構函式。終結容器清除所有項目。因此，項目型別是 ref 類別的容器確保項目不使用得比容器的。請注意，然而，容器控制碼做 not 終結的項目。