vector (STL/CLR)

發行項
06/07/2013

樣板類別說明控制不同的長度一連串的項目具有隨機存取的物件。您可以使用容器vector來管理元素的順序為連續區塊的儲存空間。此區塊會實作為陣列，依需要成長。

在下列描述中GValue等同於Value其餘後者則是參考型別，在這種情況是Value^。

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

參數

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

Members

型別定義	描述
vector::const_iterator (STL/CLR)	常數的 iterator 受控制序列的型別。
vector::const_reference (STL/CLR)	常數參考的項目型別。
vector::const_reverse_iterator (STL/CLR)	常數的反向 iterator 受控制序列的型別。
vector::difference_type (STL/CLR)	帶正負號的距離，兩個元素之間的型別。
vector::generic_container (STL/CLR)	泛用介面，該容器的型別。
vector::generic_iterator (STL/CLR)	Iterator 容區的泛用介面的型別。
vector::generic_reverse_iterator (STL/CLR)	反向 iterator 容區的泛用介面的型別。
vector::generic_value (STL/CLR)	為泛用介面，該容器的項目型別。
vector::iterator (STL/CLR)	受控制序列的 iterator 型別。
vector::reference (STL/CLR)	項目之參考型別。
vector::reverse_iterator (STL/CLR)	對於受控制序列的反向 iterator 型別。
vector::size_type (STL/CLR)	帶正負號的距離，兩個元素之間的型別。
vector::value_type (STL/CLR)	項目的型別。

成員函式	描述
vector::assign (STL/CLR)	取代所有的項目。
vector::at (STL/CLR)	存取位於指定位置的項目。
vector::back (STL/CLR)	存取最後一個項目。
vector::begin (STL/CLR)	指定受控制序列的開頭。
vector::capacity (STL/CLR)	報告容器配置儲存區的大小。
vector::clear (STL/CLR)	移除所有項目。
vector::empty (STL/CLR)	測試是否沒有項目呈現。
vector::end (STL/CLR)	指定受控制序列的結尾。
vector::erase (STL/CLR)	移除指定位置的項目。
vector::front (STL/CLR)	存取第一個項目。
vector::insert (STL/CLR)	將元素加入指定的位置。
vector::pop_back (STL/CLR)	移除最後一個項目。
vector::push_back (STL/CLR)	將新的最後一個項目。
vector::rbegin (STL/CLR)	指定已還原的受控制序列開頭。
vector::rend (STL/CLR)	指定已還原的受控制序列結尾。
vector::reserve (STL/CLR)	可確保容器最小的成長容量。
vector::resize (STL/CLR)	變更項目的數目。
vector::size (STL/CLR)	計數項目的數目。
vector::swap (STL/CLR)	交換兩個容器的內容。
vector::to_array (STL/CLR)	將受控制的序列複製到新的陣列。
vector::vector (STL/CLR)	建構容器物件。

屬性	描述
vector::back_item (STL/CLR)	存取最後一個項目。
vector::front_item (STL/CLR)	存取第一個項目。

運算子	描述
vector::operator= (STL/CLR)	取代受控制的序列。
vector::operator[] (STL/CLR)	存取位於指定位置的項目。
operator!= (vector) (STL/CLR)	如果決定vector不等於另一個物件是vector物件。
operator< (vector) (STL/CLR)	如果決定vector物件是小於另一個vector物件。
operator<= (vector) (STL/CLR)	如果決定vector物件是小於或等於到另一個vector物件。
operator== (vector) (STL/CLR)	如果決定vector物件是否等於另一個vector物件。
operator> (vector) (STL/CLR)	如果決定vector物件是否大於另一個vector物件。
operator>= (vector) (STL/CLR)	如果決定vector物件是大於或等於另一個vector物件。

介面

介面	描述
ICloneable	重複的物件。
IEnumerable	序列項目。
ICollection	維持群組項目。
IEnumerable<T>	透過型別元素的順序。
ICollection<T>	維護具型別項目的群組。
IList<T>	維護已排序的群組的具型別項目。
IVector <Value>	維護泛用的容器。

備註

物件會配置並釋放它控制透過預存的陣列的順序儲存Value項目，視需要成長。一種將附加新的項目成本是固定的 amortized 的時間，就會發生的成長。亦即在結尾加入項目成本並不會增加，平均而言，以受控制的序列愈大的長度。因此，向量是樣板類別為基礎的容器的理想候選stack (STL/CLR)。

A vector支援隨機存取 iterator，這表示您可以參考陣列元素直接指定其數值的位置，可計算從零 (前端) 的第一個項目，如vector::size (STL/CLR)() - 1的最後一個 (上一步) 項目。這也表示向量是樣板類別為基礎的容器的理想候選priority_queue (STL/CLR)。

向量 iterator 會儲存其相關聯的向量物件，並的項目後，它指定偏差的控制代碼。Iterator 只適用於其相關的容器物件。向量元素的偏差等同於它的位置。

插入或刪除項目可以變更儲存位於給定位置，讓 iterator 所指定的值也可以變更的項目值。(容器可能需要將複製的項目，或向下建立一個洞，在插入之前先或填滿之後清除的洞裡)。不過，向量 iterator 仍然有效，只要其偏差範圍是[0, vector::size (STL/CLR)()]。此外，有效的 iterator 保持 dereferencable--您可用它來存取或修改後，它指定-項目值，只要其偏差值不等於書籤size()。

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