CKTIS / Java
Collection.spliterator — prolazak kroz elemente kolekcije
Collection.spliterator() vraća objekt za prolazak kroz elemente kolekcije i moguće dijeljenje posla. Saznajte više o zadanoj implementaciji, značajkama veličine i ograničenjima povezanima s izmjenama i istodobnošću.
Verzija: Java SE 21; repository runtime, production runtime not attested
Sintaksa
default Spliterator<E> spliterator()Collection.spliterator() vraća Spliterator<E> nad elementima kolekcije. tryAdvance(action) obrađuje jedan element i vraća true, a kada više nema elemenata, vraća false. forEachRemaining(action) obrađuje preostale elemente. trySplit() može izdvojiti dio posla u drugi spliterator ili vratiti null; njegov poziv ne pokreće dretve.
Zadana implementacija Collection upotrebljava Iterator, kasno se povezuje s izvorom i nasljeđuje njegova fail-fast svojstva. Navodi SIZED i SUBSIZED: početna je veličina točna ako nema strukturnih izmjena, a poznatu veličinu imaju i spliteratori dobiveni dijeljenjem. Konkretne kolekcije mogu nadjačati ovu metodu; provjerite njihovu dokumentaciju.
Kasno povezivanje događa se pri prvom prolasku, dijeljenju ili upitu o procijenjenoj veličini. Ono ne podrazumijeva snimku ni sigurnost pri radu s više dretvi. Fail-fast otkrivanje samo je najbolji pokušaj otkrivanja pogreške, a ne mehanizam sinkronizacije. Ako implementacija izričito ne jamči drukčije, nemojte mijenjati izvor tijekom prolaska.
Zadane metode stream() i parallelStream() upotrebljavaju spliterator kolekcije; mogućnost dijeljenja ne jamči ubrzanje. Primjer upotrebljava uređeni List, pa ispisuje elemente redoslijedom popisa. Samo sučelje Collection ne jamči taj redoslijed.
Primjeri
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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.