Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje