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.