Platform::Collections::VectorView 類別

發行項
01/10/2024

代表物件之循序集合的唯讀檢視，這些物件可透過索引加以個別存取。集合中每個物件的類型，由樣板參數指定。

語法

template <typename T, typename E>
   ref class VectorView sealed;

參數

T
VectorView 物件中包含的元素類型。

E
指定二元述詞，以測試是否與 T型別的值相等。預設值是 std::equal_to<T>。

備註

類別 VectorView 會實作 Windows：：Foundation：：Collections：：IVectorView<T> 介面，並支援標準範本連結庫反覆運算器。

成員

公用建構函式

名稱	描述
VectorView：：VectorView	初始化 VectorView 類別的新執行個體。

公用方法

名稱	描述
VectorView：：First	傳回迭代器，指定 VectorView 中的第一個項目。
VectorView：：GetAt	擷取由指定之索引所表示的目前 VectorView 項目。
VectorView：：GetMany	由指定的索引處開始，從目前 VectorView 擷取一連串項目。
VectorView：：IndexOf	在目前 VectorView 中搜尋指定的項目，如果找到，則傳回項目的索引。
VectorView：：Size	傳回目前 VectorView 物件中的項目數。

繼承階層架構

VectorView

需求

標頭： collection.h

命名空間： Platform::Collections

VectorView::First 方法

傳回迭代器，指定 VectorView 中的第一個項目。

語法

virtual Windows::Foundation::Collections::IIterator<T>^
   First();

傳回值

指定 VectorView 中第一個項目的迭代器。

備註

保留 First（）所傳回反覆運算器的便利方式是將傳回值指派給以類型推算關鍵詞宣告的 auto 變數。例如： auto x = myVectorView->First(); 。

VectorView::GetAt 方法

擷取由指定之索引所表示的目前 VectorView 項目。

語法

T GetAt(
   UInt32 index
);

參數

index
以零起始、不帶正負號的整數，在 VectorView 物件中指定特別項目。

傳回值

index 參數指定的項目。元素類型是由 VectorView 樣本參數 T 所指定。

VectorView::GetMany 方法

由指定的索引處開始，從目前 VectorView 擷取一連串項目。

語法

virtual unsigned int GetMany(
   unsigned int startIndex,
   ::Platform::WriteOnlyArray<T>^ dest
);

參數

startIndex
要擷取之開始項目以零為起始的索引。

dest
當這項作業完成後，是項目陣列，從 startIndex 指定的項目開始，到 VectorView 的最後一個項目結束。

傳回值

擷取的項目數目。

Vectorview:: Indexof 方法

在目前 VectorView 中搜尋指定的項目，如果找到，則傳回項目的索引。

語法

virtual bool IndexOf(
   T value,
   unsigned int* index
);

參數

value
要尋找的項目。

index
如果找到參數 value，則為項目以零起始的索引，否則為 0。

如果專案是的第一VectorView個專案，或找不到專案，則索引參數為 0。如果傳回值為 true，則找到專案且它是第一個項目，否則找不到專案。

傳回值

true 如果找到指定的專案，則為 ;否則為 false。

VectorView::Size 方法

傳回目前 VectorView 物件中的項目數。

語法

virtual property unsigned int Size;

傳回值

目前 VectorView 中的項目數。

VectorView::VectorView 建構函式

初始化 VectorView 類別的新執行個體。

語法

VectorView();
explicit VectorView(
   UInt32 size
);
VectorView(
   UInt32 size,
   T value
);
explicit VectorView(
   const ::std::vector<T>& v
);
explicit VectorView(
   ::std::vector<T>&& v
);
VectorView(
   const T * ptr,
   UInt32 size
);

template <
   size_t N
>
explicit VectorView(
   const T (&arr)[N]
);

template <
   size_t N
>
explicit VectorView(
   const ::std::array<T,
   N>& a
);

explicit VectorView(
   const ::Platform::Array<T>^ arr
);

template <
   typename InIt
>
VectorView(
   InItfirst,
   InItlast
);

VectorView(
   std::initializer_list<T> il
);

參數

InIt
用來初始化目前 VectorView 的物件集合類型。

il
std：：initializer_list，其專案將用來初始化 VectorView。

否
用來初始化目前 VectorView 之物件集合中的項目數。

size
VectorView 中的項目數。

value
用來初始化目前 VectorView 中各個項目的值。

v
Lvalues 和 Rvalues 至 std：：vector，用來初始化目前的 VectorView。

ptr
用來初始化目前 VectorView 之 std::vector 的指標。

arr
Platform：：Array 物件，用來初始化目前的 VectorView。

a
std：：array 物件，用來初始化目前的 VectorView。

first
用來初始化目前 VectorView 之物件序列中的第一個項目。的型 first 別會透過 完美的轉送方式傳遞。如需詳細資訊，請參閱右值參考宣告子：&&。

last
用來初始化目前 VectorView 之物件序列中的最後一個項目。的型 last 別會透過 完美的轉送方式傳遞。如需詳細資訊，請參閱右值參考宣告子：&&。

另請參閱

平台命名空間
 在 C++ 中建立 Windows 執行階段元件

共用方式為