Platform::Collections::VectorIterator 类

为从 Windows 运行时 IVector 接口派生的对象提供标准模板库迭代器。

VectorIterator 是存储 VectorProxy<T>类型的元素的代理迭代器。 不过，代理对象对于用户代码应该不可见。 有关更多信息，请参见 集合 (C++/CX)。

语法

template <typename T>
class VectorIterator;

参数

T
VectorIterator 模板类的类型名称。

成员

公共 Typedef

名称	描述
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 类型名称。

公共构造函数

名称	描述
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 不等于“其他”，则为 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 VectorIterator1 之间的元素数。

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 的类型名。

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 的显式构造函数。

另请参阅

Platform 命名空间