Iterator Class

Dokumentation der Mitgliedsfunktionen

[constexpr noexcept] Iterator::Iterator()

Konstruiert einen uninitialisierten Iterator.

Funktionen wie key(), value() und operator++() dürfen nicht mit einem nicht initialisierten Iterator aufgerufen werden. Verwenden Sie operator=(), um ihm einen Wert zuzuweisen, bevor Sie ihn verwenden.

Siehe auch QCborMap::begin() und QCborMap::end().

[constexpr noexcept] Iterator::Iterator(const QCborMap::Iterator &other)

Konstruiert einen Iterator als eine Kopie von other.

QCborValue Iterator::key() const

Gibt den Schlüssel des aktuellen Elements zurück.

Es gibt keine direkte Möglichkeit, den Schlüssel eines Elements durch einen Iterator zu ändern, obwohl dies durch den Aufruf von QCborMap::erase() gefolgt von QCborMap::insert() möglich ist.

Siehe auch value().

QCborValueRef Iterator::value() const

Gibt einen veränderbaren Verweis auf den Wert des aktuellen Elements zurück.

Sie können den Wert für einen Schlüssel ändern, indem Sie value() auf der linken Seite einer Zuweisung verwenden.

Der Rückgabewert ist vom Typ QCborValueRef, einer Hilfsklasse für QCborArray und QCborMap. Wenn Sie ein Objekt vom Typ QCborValueRef erhalten, können Sie es so verwenden, als wäre es eine Referenz auf QCborValue. Wenn Sie es zuweisen, gilt die Zuweisung für das Element in QCborArray oder QCborMap, von dem Sie die Referenz erhalten haben.

Siehe auch key() und operator*().

QCborMap::Iterator::value_type Iterator::operator*() const

Gibt ein Paar zurück, das den Schlüssel des aktuellen Elements und einen änderbaren Verweis auf den Wert des aktuellen Elements enthält.

Das zweite Element des Paares ist vom Typ QCborValueRef, einer Hilfsklasse für QCborArray und QCborMap. Wenn Sie ein Objekt vom Typ QCborValueRef erhalten, können Sie es so verwenden, als wäre es eine Referenz auf QCborValue. Wenn Sie es zuweisen, gilt die Zuweisung für das Element in QCborArray oder QCborMap, von dem Sie die Referenz erhalten haben.

Siehe auch key() und value().

QCborMap::Iterator Iterator::operator+(qsizetype j) const

Gibt einen Iterator zu dem Element an j Positionen vor diesem Iterator zurück. Wenn j negativ ist, geht der Iterator rückwärts.

Siehe auch operator-().

QCborMap::Iterator &Iterator::operator++()

Der Präfix-Operator ++, ++i, setzt den Iterator auf das nächste Element in der Map und gibt diesen Iterator zurück.

Der Aufruf dieser Funktion auf QCborMap::end() führt zu undefinierten Ergebnissen.

Siehe auch operator--().

QCborMap::Iterator Iterator::operator++(int)

Dies ist eine überladene Funktion.

Der Postfix-Operator ++, i++, setzt den Iterator auf das nächste Element in der Map und gibt einen Iterator auf das zuvor aktuelle Element zurück.

QCborMap::Iterator &Iterator::operator+=(qsizetype j)

Bringt den Iterator um j Elemente weiter. Wenn j negativ ist, geht der Iterator rückwärts. Gibt einen Verweis auf diesen Iterator zurück.

Siehe auch operator-=() und operator+().

qsizetype Iterator::operator-(QCborMap::Iterator j) const

Gibt die Position des Elements im Iterator j relativ zum Element in diesem Iterator zurück. Wenn das Element bei j vor diesem Zeitpunkt liegt, ist der zurückgegebene Wert negativ.

Siehe auch operator+().

QCborMap::Iterator Iterator::operator-(qsizetype j) const

Gibt einen Iterator zu dem Element an j Positionen rückwärts von diesem Iterator zurück. Wenn j negativ ist, geht der Iterator vorwärts.

Siehe auch operator+().

QCborMap::Iterator &Iterator::operator--()

Der vorangestellte Operator --, --i, macht das vorhergehende Element aktuell und gibt diesen Iterator zurück.

Der Aufruf dieser Funktion auf QCborMap::begin() führt zu undefinierten Ergebnissen.

Siehe auch operator++().

QCborMap::Iterator Iterator::operator--(int)

Dies ist eine überladene Funktion.

Der Postfix-Operator --, i--, macht das vorhergehende Element aktuell und gibt einen Iterator zurück, der auf das zuvor aktuelle Element zeigt.

QCborMap::Iterator &Iterator::operator-=(qsizetype j)

Bringt den Iterator dazu, um j Elemente zurück zu gehen. Wenn j negativ ist, geht der Iterator vorwärts. Gibt einen Verweis auf diesen Iterator zurück.

Siehe auch operator+=() und operator-().

const QCborValueConstRef *Iterator::operator->() const

Gibt einen Zeiger auf einen veränderbaren Verweis auf den Wert des aktuellen Paares zurück.

QCborMap::Iterator &Iterator::operator=(const QCborMap::Iterator &other)

Macht diesen Iterator zu einer Kopie von other und gibt eine Referenz auf diesen Iterator zurück.