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.