QMutableLinkedListIterator Class

Dokumentation der Mitgliedsfunktionen

QMutableLinkedListIterator::QMutableLinkedListIterator(QLinkedList<T> &list)

Konstruiert einen Iterator zum Durchlaufen von list. Der Iterator wird so gesetzt, dass er am Anfang der Liste steht (vor dem ersten Element).

Siehe auch operator=().

QMutableLinkedListIterator<T> &QMutableLinkedListIterator::operator=(QLinkedList<T> &list)

Lässt den Iterator auf list arbeiten. Der Iterator wird so eingestellt, dass er am Anfang der Liste steht (vor dem ersten Element).

Siehe auch toFront() und toBack().

void QMutableLinkedListIterator::toFront()

Verschiebt den Iterator an den Anfang des Containers (vor das erste Element).

Siehe auch toBack() und next().

void QMutableLinkedListIterator::toBack()

Verschiebt den Iterator an das Ende des Containers (nach dem letzten Element).

Siehe auch toFront() und previous().

bool QMutableLinkedListIterator::hasNext() const

Gibt true zurück, wenn sich mindestens ein Element vor dem Iterator befindet, d. h. der Iterator steht nicht am Ende des Containers; andernfalls wird false zurückgegeben.

Siehe auch hasPrevious() und next().

bool QMutableLinkedListIterator::hasPrevious() const

Gibt true zurück, wenn sich mindestens ein Element hinter dem Iterator befindet, d. h. der Iterator steht nicht am Anfang des Containers; andernfalls wird false zurückgegeben.

Siehe auch hasNext() und previous().

bool QMutableLinkedListIterator::findNext(const T &value)

Sucht ab der aktuellen Iteratorposition vorwärts nach value. Gibt true zurück, wenn value gefunden wird; andernfalls false.

Nach dem Aufruf wird der Iterator, falls value gefunden wurde, direkt nach dem passenden Element positioniert; andernfalls wird der Iterator am Ende des Containers positioniert.

Siehe auch findPrevious().

bool QMutableLinkedListIterator::findPrevious(const T &value)

Sucht ab der aktuellen Iteratorposition rückwärts nach value. Gibt true zurück, wenn value gefunden wird; andernfalls wird false zurückgegeben.

Nach dem Aufruf wird der Iterator, falls value gefunden wurde, unmittelbar vor dem passenden Element positioniert; andernfalls wird der Iterator an den Anfang des Containers gesetzt.

Siehe auch findNext().

void QMutableLinkedListIterator::insert(const T &value)

Fügt value an der aktuellen Iteratorposition ein. Nach dem Aufruf befindet sich der Iterator direkt hinter dem eingefügten Element.

Siehe auch remove() und setValue().

T &QMutableLinkedListIterator::next()

Gibt einen Verweis auf das nächste Element zurück und rückt den Iterator um eine Position vor.

Der Aufruf dieser Funktion bei einem Iterator, der sich am Ende des Containers befindet, führt zu undefinierten Ergebnissen.

Siehe auch hasNext(), peekNext(), und previous().

T &QMutableLinkedListIterator::peekNext() const

Gibt einen Verweis auf das nächste Element zurück, ohne den Iterator zu verschieben.

Der Aufruf dieser Funktion bei einem Iterator, der sich am Ende des Containers befindet, führt zu undefinierten Ergebnissen.

Siehe auch hasNext(), next(), und peekPrevious().

T &QMutableLinkedListIterator::peekPrevious() const

Gibt einen Verweis auf das vorherige Element zurück, ohne den Iterator zu verschieben.

Der Aufruf dieser Funktion bei einem Iterator, der sich am Anfang des Containers befindet, führt zu undefinierten Ergebnissen.

Siehe auch hasPrevious(), previous(), und peekNext().

T &QMutableLinkedListIterator::previous()

Gibt einen Verweis auf das vorherige Element zurück und verschiebt den Iterator um eine Position zurück.

Der Aufruf dieser Funktion bei einem Iterator, der sich am Anfang des Containers befindet, führt zu undefinierten Ergebnissen.

Siehe auch hasPrevious(), peekPrevious(), und next().

void QMutableLinkedListIterator::remove()

Entfernt das letzte Element, das mit einer der Traversalfunktionen (next(), previous(), findNext(), findPrevious()) übersprungen wurde.

Beispiel:

QMutableLinkedListIterator<int> i(list);
while (i.hasNext()) {
    int val = i.next();
    if (val < -32768 || val > 32767)
        i.remove();
}

Siehe auch insert() und setValue().

void QMutableLinkedListIterator::setValue(const T &value) const

Ersetzt den Wert des letzten Elements, das mit einer der Traversalfunktionen übersprungen wurde, durch value.

Die Überspringungsfunktionen sind next(), previous(), findNext() und findPrevious().

Beispiel:

QMutableLinkedListIterator<double> i(list);
while (i.hasNext()) {
    double val = i.next();
    i.setValue(std::sqrt(val));
}

Siehe auch value(), remove(), und insert().

const T &QMutableLinkedListIterator::value() const

Gibt den Wert des letzten Elements zurück, das mit einer der Traversalfunktionen (next(), previous(), findNext(), findPrevious()) übersprungen wurde.

Nach einem Aufruf von next() oder findNext() ist value() äquivalent zu peekPrevious(). Nach einem Aufruf von previous() oder findPrevious() ist value() gleichbedeutend mit peekNext().

Siehe auch setValue().

T &QMutableLinkedListIterator::value()

Dies ist eine überladene Funktion.

Gibt eine Nicht-Konst-Referenz auf den Wert des letzten Elements zurück, das mit einer der Traversalfunktionen übersprungen wurde.