list (STL/CLR)

發行項
06/07/2013

樣板類別說明控制不同的長度一連串的項目具有雙向」存取權的物件。您可以使用容器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>
    { ..... };

參數

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

Members

型別定義	描述
list::const_iterator (STL/CLR)	常數的 iterator 受控制序列的型別。
list::const_reference (STL/CLR)	常數參考的項目型別。
list::const_reverse_iterator (STL/CLR)	常數的反向 iterator 受控制序列的型別。
list::difference_type (STL/CLR)	帶正負號的距離，兩個元素之間的型別。
list::generic_container (STL/CLR)	泛用介面，該容器的型別。
list::generic_iterator (STL/CLR)	Iterator 容區的泛用介面的型別。
list::generic_reverse_iterator (STL/CLR)	反向 iterator 容區的泛用介面的型別。
list::generic_value (STL/CLR)	為泛用介面，該容器的項目型別。
list::iterator (STL/CLR)	受控制序列的 iterator 型別。
list::reference (STL/CLR)	項目之參考型別。
list::reverse_iterator (STL/CLR)	對於受控制序列的反向 iterator 型別。
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<T>	透過型別元素的順序。
ICollection<T>	維護具型別項目的群組。
IList <Value>	維護泛用的容器。

備註

物件會配置並釋放它控制以雙向連結清單中的個別節點的順序儲存。它會藉由改變而非由一個節點的內容複製到另一個節點之間的連結重新排列項目。也就是說，您可以插入和移除項目自由不干擾其餘的項目。因此，清單是樣板類別為基礎的容器的理想候選queue (STL/CLR)或樣板類別stack (STL/CLR)。

A list物件支援雙向 iterator，這表示您可以前往相鄰的項目提供 iterator，指派受控制序列中的項目。特殊的主節點相對於所傳回的 iterator list::end (STL/CLR)()。如果有的話，您可以減少到達最後一個項目，在受控制序列中，這個 iterator 的規定。您可以遞增清單 iterator 到達主節點，以及它接著會比對是否等於end()。您不能解除參考所傳回的 iterator，但是end()。

請注意您不能參照到清單項目直接指定其數值的位置--需要隨機存取 iterator。因此，清單會not當做樣板類別為基礎的容器priority_queue (STL/CLR)。

清單 iterator 會儲存其相關聯的清單] 節點，接著會儲存與其相關聯的容器的控制代碼的控制代碼。 Iterator 只適用於其相關的容器物件。會依其相關聯的清單節點已經有一些清單，清單 iterator 仍然有效。此外，有效的 iterator 是 dereferencable--您可以使用它來存取或修改後，它指定-項目值，只要不等於書籤end()。

正在清除或移除項目儲存的值會呼叫解構函式。摧毀容器時，會清除所有項目。因此，的容器，其元素型別是一種 ref 類別可確保沒有項目 outlive 的容器。不過請注意，容器的控制代碼不會not摧毀它的項目。