CKTIS / Java
Collection.spliterator — procházení prvků kolekce
Collection.spliterator() vrací objekt pro procházení prvků kolekce a případné rozdělení práce. Seznamte se s výchozí implementací, vlastnostmi velikosti a omezeními týkajícími se změn a souběžnosti.
Verze: Java SE 21; repository runtime, production runtime not attested
Syntaxe
default Spliterator<E> spliterator()Collection.spliterator() vrací Spliterator<E> nad prvky kolekce. tryAdvance(action) zpracuje jeden prvek a vrátí true, případně při vyčerpání prvků vrátí false. forEachRemaining(action) zpracuje zbývající prvky. trySplit() může oddělit část práce do dalšího spliteratoru nebo vrátit null; jeho zavolání nespouští vlákna.
Výchozí implementace Collection používá Iterator, váže se ke zdroji opožděně a přebírá jeho vlastnosti fail-fast. Uvádí SIZED a SUBSIZED: počáteční velikost je přesná, pokud nedojde ke strukturálním změnám, a známou velikost mají i spliteratory vzniklé rozdělením. Konkrétní kolekce mohou tuto metodu přepsat; podívejte se do jejich dokumentace.
K opožděnému navázání dojde při prvním průchodu, rozdělení nebo dotazu na odhadovanou velikost. Neznamená to vytvoření snímku ani bezpečnost při souběžném přístupu. Detekce fail-fast je pouze nejlepším možným pokusem o odhalení chyby, nikoli synchronizačním mechanismem. Pokud implementace výslovně nezaručuje opak, během průchodu zdroj neměňte.
Výchozí metody stream() a parallelStream() používají spliterator kolekce; možnost rozdělení nezaručuje zrychlení. Příklad používá uspořádaný List, takže vypíše prvky v pořadí seznamu. Samotné rozhraní Collection toto pořadí nezaručuje.
Příklady
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));
}
}Výsledek
3 10 20 30 false
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.