WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

Collection.spliterator — Elemente einer Collection durchlaufen

Collection.spliterator() gibt ein Objekt zurück, mit dem sich Elemente einer Collection durchlaufen und die Arbeit gegebenenfalls aufteilen lässt. Hier erfahren Sie mehr über die Standardimplementierung, Größenmerkmale sowie Einschränkungen bei Änderungen und Nebenläufigkeit.

Version: Java SE 21; repository runtime, production runtime not attested

Syntax

default Spliterator<E> spliterator()

Collection.spliterator() gibt einen Spliterator<E> über die Elemente der Collection zurück. tryAdvance(action) verarbeitet ein Element und gibt true zurück; ist der Spliterator erschöpft, gibt die Methode false zurück. forEachRemaining(action) verarbeitet die übrigen Elemente. trySplit() kann einen Teil der Arbeit als eigenen Spliterator abtrennen oder null zurückgeben; der Aufruf startet keine Threads.

Die Standardimplementierung von Collection verwendet einen Iterator, bindet spät an die Quelle und übernimmt dessen Fail-fast-Eigenschaften. Sie meldet SIZED und SUBSIZED: Ohne strukturelle Änderungen ist die anfängliche Größe exakt, und auch durch Aufteilen erzeugte Spliteratoren haben bekannte Größen. Konkrete Collections können diese Methode überschreiben; beachten Sie deren Dokumentation.

Die späte Bindung erfolgt beim ersten Durchlauf, Aufteilen oder Abfragen der geschätzten Größe. Sie bedeutet weder, dass ein Snapshot erstellt wird, noch Thread-Sicherheit. Fail-fast-Erkennung ist lediglich ein bestmöglicher Versuch, Fehler zu erkennen, und kein Synchronisationsmechanismus. Ändern Sie die Quelle während des Durchlaufs nicht, sofern die Implementierung dies nicht ausdrücklich garantiert.

Die Standardmethoden stream() und parallelStream() verwenden den Spliterator der Collection; die Möglichkeit zur Aufteilung garantiert keine Beschleunigung. Das Beispiel verwendet eine geordnete List und gibt die Elemente daher in Listenreihenfolge aus. Das Collection-Interface allein garantiert diese Reihenfolge nicht.

Beispiele

import java.util.Collection;
import java.util.List;
import java.util.Spliterator;

public class Main {
    public static void main(String[] args) {
        Collection<Integer> values = List.of(10, 20, 30);
        Spliterator<Integer> cursor = values.spliterator();

        System.out.println(cursor.getExactSizeIfKnown());
        cursor.tryAdvance(System.out::println);
        cursor.forEachRemaining(System.out::println);
        System.out.println(cursor.tryAdvance(System.out::println));
    }
}

Ergebnis

3
10
20
30
false

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen