Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Collection.spliterator — przechodzenie po elementach kolekcji

Collection.spliterator() zwraca obiekt do przechodzenia po elementach kolekcji i ewentualnego dzielenia pracy. Poznaj domyślną implementację, cechy rozmiaru oraz ograniczenia dotyczące modyfikacji i współbieżności.

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

Składnia

default Spliterator<E> spliterator()

Collection.spliterator() zwraca Spliterator<E> dla elementów kolekcji. tryAdvance(action) przetwarza jeden element i zwraca true, a po wyczerpaniu elementów — false. forEachRemaining(action) przetwarza pozostałe elementy. trySplit() może wydzielić część pracy jako osobny spliterator albo zwrócić null; samo wywołanie nie uruchamia wątków.

Domyślna implementacja Collection korzysta z Iterator, stosuje późne wiązanie ze źródłem i dziedziczy jego właściwości fail-fast. Zgłasza SIZED oraz SUBSIZED: początkowy rozmiar jest dokładny przy braku zmian strukturalnych, a spliteratory uzyskane przez podział również mają znany rozmiar. Konkretne kolekcje mogą nadpisywać tę metodę; sprawdzaj ich dokumentację.

Późne wiązanie następuje przy pierwszym przejściu, podziale lub zapytaniu o szacowany rozmiar. Nie oznacza migawki ani bezpieczeństwa wątkowego. Wykrywanie zmian przez fail-fast jest tylko próbą wykrycia błędu, nie mechanizmem synchronizacji. Bez wyraźnej gwarancji implementacji nie modyfikuj źródła podczas przechodzenia.

Domyślne stream() i parallelStream() korzystają ze spliteratora kolekcji; możliwość podziału nie gwarantuje przyspieszenia. Przykład używa uporządkowanej List, więc wypisuje elementy w kolejności listy. Sam interfejs Collection nie gwarantuje takiej kolejności.

Przykłady

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));
    }
}

Wynik

3
10
20
30
false

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła