Platform::Collections::VectorIterator 類別

為衍生自 Windows 執行階段 IVector 介面的物件提供標準範本程式庫迭代器。

VectorIterator 這個 Proxy 迭代器可以儲存類型為 VectorProxy<T>的元素。 不過，對使用者程式碼來說，Proxy 物件永遠都像是不存在一樣。 如需詳細資訊，請參閱 集合 (C++/CX)。

語法

template <typename T>
class VectorIterator;

參數

T
VectorIterator 範本類別的 typename。

成員

公用 Typedefs

名稱	描述
difference_type	指標差異 (ptrdiff_t)。
iterator_category	隨機存取迭代器的分類 (::std::random_access_iterator_tag)。
pointer	VectorIterator 的實作所需的內部類型 Platform::Collections::Details::VectorProxy<T> 指標。
reference	VectorIterator 的實作所需的內部類型 Platform::Collections::Details::VectorProxy<T> 參考。
value_type	T typename。

公用建構函式

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

公用運算子

名稱	描述
VectorIterator::operator- 運算子	從目前迭代器減去指定的項目數而產生新的迭代器，或從目前迭代器減去指定的迭代器而產生迭代器之間的項目數。
VectorIterator::operator-- 運算子	遞減目前 VectorIterator。
VectorIterator::operator!= 運算子	指出目前 VectorIterator 是否不等於指定的 VectorIterator。
VectorIterator::operator* 運算子	擷取目前 VectorIterator 指定之元素的參考。
VectorIterator::operator[]	擷取從目前 VectorIterator 開始指定偏移的元素的參考。
VectorIterator::operator+ 運算子	傳回 VectorIterator ，參考從指定的 VectorIterator 開始指定位移的項目。
VectorIterator::operator++ 運算子	遞增目前 VectorIterator。
VectorIterator::operator+= 運算子	依指定的位移值遞增目前 VectorIterator。
VectorIterator::operator< 運算子	指出目前 VectorIterator 是否小於指定的 VectorIterator。
VectorIterator::operator<= 運算子	指出目前 VectorIterator 是否小於或等於指定的 VectorIterator。
VectorIterator::operator-= 運算子	依指定的位移遞減目前 VectorIterator。
VectorIterator::operator== 運算子	指出目前 VectorIterator 是否等於指定的 VectorIterator。
VectorIterator::operator> 運算子	指出目前 VectorIterator 是否大於指定的 VectorIterator。
VectorIterator::operator-> 運算子	擷取目前 VectorIterator 參考的元素的位址。
VectorIterator::operator>= 運算子	指出目前 VectorIterator 是否大於或等於指定的 VectorIterator。

繼承階層架構

VectorIterator

需求

標頭： collection.h

命名空間：Platform::Collections

VectorIterator::operator-> 算子

擷取目前 VectorIterator 參考的元素的位址。

語法

Detail::ArrowProxy<T> operator->() const;

傳回值

目前 VectorIterator 參考的元素值。

傳回值的類型是實作這個運算子所需之未指定的內部類型。

VectorIterator::operator-- 運算子

遞減目前 VectorIterator。

語法

VectorIterator& operator--();
VectorIterator operator--(int);

傳回值

第一種語法會先遞減，再傳回目前的 VectorIterator。 第二個語法會傳回目前 VectorIterator 的複本，然後遞減目前的 VectorIterator。

備註

第一種 VectorIterator 語法會預先遞減目前的 VectorIterator。

第二種語法會後置遞減目前的 VectorIterator。 第二種語法中的 int 類型表示後置遞減作業，不是實際的整數運算元。

VectorIterator::operator* 運算子

擷取目前 VectorIterator 指定的元素位址。

語法

reference operator*() const;

傳回值

目前 VectorIterator 指定的元素。

VectorIterator::operator== 運算子

指出目前的 VectorIterator 是否等於指定的 VectorIterator。

語法

bool operator==(const VectorIterator& other) const;

參數

other
另一個 VectorIterator。

傳回值

如果目前 VectorIterator 等於 other 則為 true，否則為 false。

VectorIterator::operator> 運算子

指出目前的 VectorIterator 是否大於指定的 VectorIterator。

語法

bool operator>(const VectorIterator& other) const

參數

other
另一個 VectorIterator。

傳回值

如果目前 VectorIterator 大於 other 則為 true，否則為 false。

VectorIterator::operator>= 運算子

指出目前 VectorIterator 是否大於或等於指定的 VectorIterator。

語法

bool operator>=(const VectorIterator& other) const

參數

other
另一個 VectorIterator。

傳回值

如果目前 VectorIterator 大於或等於 other 則為 true，否則為 false。

VectorIterator::operator++ 運算子

遞增目前的 VectorIterator。

語法

VectorIterator& operator++();
VectorIterator operator++(int);

傳回值

第一種語法會先遞增，再傳回目前的 VectorIterator。 第二個語法會傳回目前 VectorIterator 的複本，然後遞增目前的 VectorIterator。

備註

第一個 VectorIterator 語法會預先遞增目前的 VectorIterator。

第二種語法會之後遞增目前的 VectorIterator。 第二個語法中的 int 類型代表後置遞增作業，而不是實際的整數運算元。

VectorIterator::operator!= 運算子

指出目前的 VectorIterator 是否不等於指定的 VectorIterator。

語法

bool operator!=(const VectorIterator& other) const;

參數

other
另一個 VectorIterator。

傳回值

若目前的 VectorIterator 不等於 other 則為 true，否則為 false。

VectorIterator::operator< 運算子

指出目前的 VectorIterator 是否小於指定的 VectorIterator。

語法

bool operator<(const VectorIterator& other) const

參數

other
另一個 VectorIterator。

傳回值

如果目前的 VectorIterator 小於 other 則為 true，否則為 false。

VectorIterator::operator<= 運算子

指出目前的 VectorIterator 是否小於或等於指定的 VectorIterator。

語法

bool operator<=(const VectorIterator& other) const

參數

other
另一個 VectorIterator。

傳回值

如果目前 VectorIterator 小於或等於 other 則為 true，否則為 false。

VectorIterator::operator- 運算子

從目前迭代器減去指定的項目數而產生新的迭代器，或從目前迭代器減去指定的迭代器而產生迭代器之間的項目數。

語法

VectorIterator operator-(difference_type n) const;

difference_type operator-(const VectorIterator& other) const;

參數

n
項目數。

other
另一個 VectorIterator。

傳回值

第一個運算子語法會傳回 VectorIterator 物件，該物件是小於目前 VectorIterator 的 n 元素。 第二個運算符語法會傳回目前 與 other VectorIterator之間的項目數目。

VectorIterator::operator+= 運算子

依指定的位移遞增目前的 VectorIterator。

語法

VectorIterator& operator+=(difference_type n);

參數

n
整數位移。

傳回值

更新的 VectorIterator。

VectorIterator::operator+ 運算子

傳回 VectorIterator，參考從指定的 VectorIterator 開始指定位移的元素。

語法

VectorIterator operator+(difference_type n);

template <typename T>
inline VectorIterator<T> operator+(
  ptrdiff_t n,
  const VectorIterator<T>& i);

參數

T
在第二個語法中是 VectorIterator 的 typename。

n
整數位移。

i
在第二個語法中是 VectorIterator。

傳回值

在第一個語法中是 VectorIterator，參考從目前 VectorIterator 開始指定位移的元素。

在第二個語法中是 VectorIterator，參考從參數 i 的開頭開始指定位移的元素。

備註

第一個語法範例

VectorIterator::operator-= 運算子

依指定的位移遞減目前的 VectorIterator。

語法

VectorIterator& operator-=(difference_type n);

參數

n
整數位移。

傳回值

更新的 VectorIterator。

VectorIterator::operator[] 運算子

擷取從目前 VectorIterator 開始指定位移之元素的參考。

語法

reference operator[](difference_type n) const;

參數

n
整數位移。

傳回值

從目前 VectorIterator 位移 n 個元素的元素。

VectorIterator::VectorIterator 建構函式

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

語法

VectorIterator();

explicit VectorIterator(
   Windows::Foundation::Collections::IVector<T>^ v);

參數

v
IVector<T> 物件。

備註

第一個語法範例是預設建構函式。 第二個語法範例是明確的建構函式，用於從 IVector<T> 物件建構 VectorIterator。

另請參閱

平台命名空間