Класс Platform::Collections::VectorIterator

Предоставляет итератор стандартной библиотеки шаблонов для объектов, производных от интерфейса среда выполнения WindowsIVector.

VectorIterator — это итератор прокси-сервера, который хранит элементы типа VectorProxy<T>. Однако объект прокси-сервера практически никогда не отображается в пользовательском коде. Дополнительные сведения см. в разделе Collections (C++/CX).

Синтаксис

template <typename T>
class VectorIterator;

Параметры

T
Имя VectorIterator типа класса шаблона.

Участники

Общедоступные определения типов

Имя	Описание
difference_type	Разница указателя (ptrdiff_t).
iterator_category	Категория итератора случайного доступа (::std::random_access_iterator_tag).
pointer	Указатель на внутренний тип, Platform::Collections::Details::VectorProxy<T>необходимый для реализации VectorIterator.
reference	Ссылка на внутренний тип, Platform::Collections::Details::VectorProxy<T>требуемая для реализации VectorIterator.
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.

Возвращаемое значение

trueЗначение , falseесли текущий vectorIterator равен другому; в противном случае .

Оператор VectorIterator::operator>

Указывает, является ли текущий VectorIterator больше указанного VectorIterator.

Синтаксис

bool operator>(const VectorIterator& other) const

Параметры

other
Другой VectorIterator.

Возвращаемое значение

true Значение , если текущий vectorIterator больше other; falseв противном случае .

Оператор VectorIterator::operator>=

Указывает, больше или равно текущему объекту VectorIterator.VectorIterator

Синтаксис

bool operator>=(const VectorIterator& other) const

Параметры

other
Другой VectorIterator.

Возвращаемое значение

trueЗначение other, falseесли текущее VectorIterator значение больше или равно; в противном случае .

Оператор 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.

Возвращаемое значение

trueЗначение , falseесли текущий VectorIterator не равен другому; в противном случае .

Оператор VectorIterator::operator<

Указывает, меньше ли текущее VectorIterator значение указанного VectorIterator.

Синтаксис

bool operator<(const VectorIterator& other) const

Параметры

other
Другой VectorIterator.

Возвращаемое значение

true Значение , если текущее VectorIterator значение меньше other; falseв противном случае .

Оператор VectorIterator::operator<=

Указывает, меньше ли текущее VectorIterator значение или равно указанному.VectorIterator

Синтаксис

bool operator<=(const VectorIterator& other) const

Параметры

other
Другой VectorIterator.

Возвращаемое значение

trueЗначение other, falseесли текущее VectorIterator значение меньше или равно; в противном случае .

Оператор VectorIterator::operator-

Вычитает указанное количество элементов из текущего итератора, возвращая новый итератор, или вычитает указанный итератор из текущего итератора, возвращая количество элементов между итераторами.

Синтаксис

VectorIterator operator-(difference_type n) const;

difference_type operator-(const VectorIterator& other) const;

Параметры

n
Количество элементов.

other
Другой VectorIterator.

Возвращаемое значение

Первый синтаксис оператора возвращает VectorIterator объект, который меньше n текущего VectorIterator. Второй синтаксис оператора возвращает количество элементов между текущим и текущим 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типа объекта.

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
Целочисленная величина смещения.

Возвращаемое значение

Элемент, перемещенный n элементами из текущего VectorIterator.

Конструктор VectorIterator::VectorIterator

Инициализирует новый экземпляр класса VectorIterator.

Синтаксис

VectorIterator();

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

Параметры

v
Объект IVector<T>.

Замечания

Первый пример синтаксиса является конструктором по умолчанию. Второй пример синтаксиса — это явный конструктор, который используется для создания VectorIterator объекта.IVector<T>

См. также

Пространство имен платформы