Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Java

Collection.spliterator — prehajanje elementov zbirke

Collection.spliterator() vrne objekt za prehajanje elementov zbirke in morebitno razdelitev dela. Spoznajte privzeto implementacijo, značilnosti velikosti ter omejitve glede spreminjanja in sočasnosti.

Različica: Java SE 21; repository runtime, production runtime not attested

Sintaksa

default Spliterator<E> spliterator()

Collection.spliterator() vrne Spliterator<E> nad elementi zbirke. tryAdvance(action) obdela en element in vrne true, ko pa elementov zmanjka, vrne false. forEachRemaining(action) obdela preostale elemente. trySplit() lahko del dela izloči v drug spliterator ali vrne null; klic ne zažene niti.

Privzeta implementacija Collection uporablja Iterator, se na vir veže pozno in podeduje njegove lastnosti fail-fast. Navaja SIZED in SUBSIZED: začetna velikost je natančna, če ni strukturnih sprememb, znano velikost pa imajo tudi spliteratorji, dobljeni z delitvijo. Konkretne zbirke lahko to metodo preglasijo; preverite njihovo dokumentacijo.

Do pozne vezave pride pri prvem prehodu, delitvi ali poizvedbi o ocenjeni velikosti. To ne pomeni posnetka niti varnosti pri delu z več nitmi. Zaznavanje fail-fast je zgolj poskus odkrivanja napak, ne mehanizem za sinhronizacijo. Če implementacija izrecno ne zagotavlja drugače, vira med prehajanjem ne spreminjajte.

Privzeti metodi stream() in parallelStream() uporabljata spliterator zbirke; možnost delitve ne zagotavlja pohitritve. Primer uporablja urejen List, zato izpiše elemente v vrstnem redu seznama. Sam vmesnik Collection tega vrstnega reda ne zagotavlja.

Primeri

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

Rezultat

3
10
20
30
false

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri