Freigeben über


Platform::Collections::VectorIterator-Klasse

Stellt einen Standardvorlagenbibliotheksiterator für die Objekte bereit, die von der Windows Runtime-Schnittstelle IVector abgeleitet werden.

VectorIterator ist ein Proxyiterator, der Elemente des Typs VectorProxy<T>speichert. Allerdings ist das Proxyobjekt fast nie für Benutzercode sichtbar. Weitere Informationen finden Sie unter Auflistungen (C++/CX).

Syntax

template <typename T>
class VectorIterator;

Parameter

T
Der Typname der Vorlagenklasse VectorIterator.

Member

Öffentliche Typedefs

Name Beschreibung
difference_type Eine Zeigerdifferenz (ptrdiff_t)
iterator_category Die Kategorie eines Iterators für zufälligen Zugriff (::std::random_access_iterator_tag)
pointer Ein Zeiger auf den internen Typ Platform::Collections::Details::VectorProxy<T>, der für die Implementierung von VectorIterator erforderlich ist
reference Ein Verweis auf den internen Typ Platform::Collections::Details::VectorProxy<T>, der für die Implementierung von VectorIterator erforderlich ist
value_type Der T -Typname.

Öffentliche Konstruktoren

Name Beschreibung
VectorIterator::VectorIterator Initialisiert eine neue Instanz der VectorIterator-Klasse.

Öffentliche Operatoren

Name Beschreibung
VectorIterator::operator--Operator Subtrahiert entweder eine angegebene Anzahl von Elementen vom aktuellen Iterator und bildet einen neuen Iterator, oder subtrahiert einen angegebenen Iterator vom aktuellen Iterator, und gibt die Anzahl von Elementen zwischen den Iteratoren zurück.
VectorIterator::operator---Operator Dekrementiert den aktuellen VectorIterator.
VectorIterator::operator!=-Operator Gibt an, ob der aktuelle VectorIterator ungleich einem angegebenen VectorIterator ist.
VectorIterator::operator*-Operator Ruft einen Verweis auf das Element ab, das vom aktuellen VectorIterator angegeben wird.
VectorIterator::operator[] Ruft einen Verweis auf das Element ab, das eine angegebene Verschiebung vom aktuellen VectorIterator ist.
VectorIterator::operator+-Operator Gibt einen VectorIterator zurück, der auf das Element an der angegebenen Verschiebung von dem angegebenen VectorIterator verweist.
VectorIterator::operator++-Operator Inkrementiert den aktuellen VectorIterator.
VectorIterator::operator+=-Operator Inkrementiert den aktuellen VectorIterator um die angegebene Verschiebung.
VectorIterator::operator<-Operator Gibt an, ob der aktuelle VectorIterator kleiner einem angegebenen VectorIterator ist.
VectorIterator::operator<=-Operator Gibt an, ob der aktuelle VectorIterator kleiner oder gleich einem angegebenen VectorIterator ist.
VectorIterator::operator-=-Operator Dekrementiert den aktuellen VectorIterator um die angegebene Verschiebung.
VectorIterator::operator==-Operator Gibt an, ob der aktuelle VectorIterator gleich einem angegebenen VectorIterator ist.
VectorIterator::operator>-Operator Gibt an, ob der aktuelle VectorIterator größer als ein angegebener VectorIterator ist.
VectorIterator::operator->-Operator Ruft die Adresse des Elements ab, auf das vom aktuellen VectorIterator verwiesen wird.
VectorIterator::operator>=-Operator Gibt an, ob der aktuelle VectorIterator größer oder gleich einem angegebenen VectorIterator ist.

Vererbungshierarchie

VectorIterator

Anforderungen

Header: collection.h

Namespace:Platform::Collections

VectorIterator::operator->-Operator

Ruft die Adresse des Elements ab, auf das vom aktuellen VectorIterator verwiesen wird.

Syntax

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

Rückgabewert

Der Wert des Elements, auf das von der aktuellen VectorIterator-Instanz verwiesen wird

Der Typ des Rückgabewerts ist ein nicht angegebener interner Typ, der für die Implementierung dieses Operators erforderlich ist.

VectorIterator::operator---Operator

Dekrementiert den aktuellen VectorIterator.

Syntax

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

Rückgabewert

Die erste Syntax dekrementiert die aktuelle VectorIterator-Instanz und gibt sie dann zurück. Die zweite Syntax gibt eine Kopie der aktuellen VectorIterator-Instanz zurück und dekrementiert dann die aktuelle VectorIterator-Instanz.

Hinweise

Die erste VectorIterator-Syntax dekrementiert die aktuelle VectorIterator-Instanz vorab.

Die zweite Syntax postdekrementiert den aktuellen VectorIterator. Der Typ int in der zweiten Syntax gibt eine Nach-Dekrementierungsoperation an, keinen tatsächlichen ganzzahligen Operanden.

VectorIterator::operator*-Operator

Ruft die Adresse des Elements ab, das von der aktuellen VectorIterator-Instanz angegeben wird.

Syntax

reference operator*() const;

Rückgabewert

Das von der aktuellen VectorIterator-Instanz angegebene Element

VectorIterator::operator==-Operator

Zeigt an, ob die aktuelle VectorIterator-Instanz dem angegebenen VectorIterator entspricht.

Syntax

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

Parameter

other
Eine weitere VectorIterator-Instanz

Rückgabewert

true, wenn die aktuelle VectorIterator-Instanz gleich other ist, andernfalls false.

VectorIterator::operator>-Operator

Gibt an, ob die aktuelle VectorIterator-Instanz größer als die angegebene VectorIterator-Instanz ist.

Syntax

bool operator>(const VectorIterator& other) const

Parameter

other
Eine weitere VectorIterator-Instanz

Rückgabewert

true, wenn die aktuelle VectorIterator-Instanz größer als other ist, andernfalls false.

VectorIterator::operator>=-Operator

Gibt an, ob die aktuelle VectorIterator-Instanz größer oder gleich der angegebenen VectorIterator-Instanz ist.

Syntax

bool operator>=(const VectorIterator& other) const

Parameter

other
Eine weitere VectorIterator-Instanz

Rückgabewert

true, wenn die aktuelle VectorIterator-Instanz größer oder gleich otherist, andernfalls false.

VectorIterator::operator++-Operator

Erhöht die aktuelle VectorIterator-Instanz.

Syntax

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

Rückgabewert

Die erste Syntax inkrementiert die aktuelle VectorIterator-Instanz und gibt sie dann zurück. Die zweite Syntax gibt eine Kopie der aktuellen VectorIterator-Instanz zurück und erhöht dann die aktuelle VectorIterator-Instanz.

Hinweise

Die erste VectorIterator-Syntax erhöht die aktuelle VectorIterator-Instanz.

Die zweite Syntax postinkrementiert die aktuelle VectorIterator-Instanz. Der Typ int in der zweiten Syntax gibt eine Nach-Inkrementierungsoperation an, keinen tatsächlichen ganzzahligen Operanden.

VectorIterator::operator!=-Operator

Zeigt an, ob die aktuelle VectorIterator-Instanz dem angegebenen VectorIterator entspricht.

Syntax

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

Parameter

other
Eine weitere VectorIterator-Instanz

Rückgabewert

true, wenn die aktuelle VectorIterator-Instanz nicht gleich other ist, andernfalls false.

VectorIterator::operator<-Operator

Gibt an, ob die aktuelle VectorIterator-Instanz kleiner als eine angegebene VectorIterator-Instanz ist.

Syntax

bool operator<(const VectorIterator& other) const

Parameter

other
Eine weitere VectorIterator-Instanz

Rückgabewert

true, wenn die aktuelle VectorIterator-Instanz kleiner als other ist, andernfalls false.

VectorIterator::operator<=-Operator

Gibt an, ob die aktuelle VectorIterator-Instanz kleiner oder gleich einer angegebenen VectorIterator-Instanz ist.

Syntax

bool operator<=(const VectorIterator& other) const

Parameter

other
Eine weitere VectorIterator-Instanz

Rückgabewert

true, wenn die aktuelle VectorIterator-Instanz kleiner oder gleich otherist, andernfalls false.

VectorIterator::operator--Operator

Subtrahiert entweder eine angegebene Anzahl von Elementen vom aktuellen Iterator und bildet einen neuen Iterator, oder subtrahiert einen angegebenen Iterator vom aktuellen Iterator, und gibt die Anzahl von Elementen zwischen den Iteratoren zurück.

Syntax

VectorIterator operator-(difference_type n) const;

difference_type operator-(const VectorIterator& other) const;

Parameter

n
Eine Anzahl von Elementen.

other
Eine weitere VectorIterator-Instanz

Rückgabewert

Die erste Operatorsyntax gibt eine VectorIterator-Instanz zurück, das n Elemente kleiner als die aktuelle VectorIterator-Instanz ist. Die Syntax des zweiten Operators gibt die Anzahl der Elemente zwischen dem aktuellen und dem other VectorIterator.

VectorIterator::operator+=-Operator

Erhöht die aktuelle VectorIterator-Instanz um die angegebene Verschiebung.

Syntax

VectorIterator& operator+=(difference_type n);

Parameter

n
Eine ganzzahlige Verschiebung.

Rückgabewert

Der aktualisierte VectorIterator.

VectorIterator::operator+-Operator

Gibt eine VectorIterator-Instanz zurück, die auf das Element bei der angegebenen Verschiebung von der angegebenen VectorIterator-Instanz verweist.

Syntax

VectorIterator operator+(difference_type n);

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

Parameter

T
In der zweiten Syntax ist es der Typnamen von VectorIterator.

n
Eine ganzzahlige Verschiebung.

i
In der zweiten Syntax ist es ein VectorIterator.

Rückgabewert

In der ersten Syntax ist es eine VectorIterator-Instanz, die auf das Element an der angegebenen Verschiebung von der aktuellen VectorIterator-Instanz verweist.

In der zweiten Syntax ist es eine VectorIterator-Instanz, die auf das Element an der angegebenen Verschiebung vom Anfang des Parameters i verweist.

Hinweise

Das erste Syntaxbeispiel

VectorIterator::operator-=-Operator

Erhöht die aktuelle VectorIterator-Instanz um die angegebene Verschiebung.

Syntax

VectorIterator& operator-=(difference_type n);

Parameter

n
Eine ganzzahlige Verschiebung.

Rückgabewert

Der aktualisierte VectorIterator.

VectorIterator::operator[]-Operator

Ruft einen Verweis auf das Element an der angegebenen Verschiebung von der aktuellen VectorIterator-Instanz ab.

Syntax

reference operator[](difference_type n) const;

Parameter

n
Eine ganzzahlige Verschiebung.

Rückgabewert

Das Element, das um n-Elemente von der aktuellen VectorIterator-Instanz versetzt ist

VectorIterator::VectorIterator-Konstruktor

Initialisiert eine neue Instanz der VectorIterator-Klasse.

Syntax

VectorIterator();

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

Parameter

v
Ein IVector<T>-Objekt.

Hinweise

Das erste Syntaxbeispiel ist der Standardkonstruktor. Das zweite Syntaxbeispiel ist ein expliziter Konstruktor, der zum Erstellen einerVectorIterator-Instanz aus einem IVector<T>-Objekt verwendet wird.

Weitere Informationen

Plattformnamespace