CKTIS / Java
Collection.spliterator — prechádzanie prvkov kolekcie
Collection.spliterator() vracia objekt na prechádzanie prvkov kolekcie a prípadné rozdelenie práce. Zistite viac o predvolenej implementácii, vlastnostiach veľkosti a obmedzeniach týkajúcich sa zmien a súbežnosti.
Verzia: Java SE 21; repository runtime, production runtime not attested
Syntax
default Spliterator<E> spliterator()Collection.spliterator() vracia Spliterator<E> nad prvkami kolekcie. tryAdvance(action) spracuje jeden prvok a vráti true, alebo pri vyčerpaní prvkov vráti false. forEachRemaining(action) spracuje zostávajúce prvky. trySplit() môže oddeliť časť práce do ďalšieho spliteratora alebo vrátiť null; jeho zavolanie nespúšťa vlákna.
Predvolená implementácia Collection používa Iterator, na zdroj sa naviaže oneskorene a preberá jeho vlastnosti fail-fast. Uvádza SIZED a SUBSIZED: počiatočná veľkosť je presná, ak nedôjde k štrukturálnym zmenám, a známu veľkosť majú aj spliteratory vytvorené rozdelením. Konkrétne kolekcie môžu túto metódu prepísať; pozrite si ich dokumentáciu.
K oneskorenému naviazaniu dôjde pri prvom prechode, rozdelení alebo požiadavke na odhadovanú veľkosť. Neznamená to vytvorenie snímky ani bezpečnosť pri súbežnom prístupe. Detekcia fail-fast je len najlepším možným pokusom o odhalenie chyby, nie synchronizačným mechanizmom. Ak implementácia výslovne nezaručuje opak, počas prechodu zdroj nemeňte.
Predvolené metódy stream() a parallelStream() používajú spliterator kolekcie; možnosť rozdelenia nezaručuje zrýchlenie. Príklad používa usporiadaný List, a preto vypíše prvky v poradí zoznamu. Samotné rozhranie Collection toto poradie nezaručuje.
Prí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ýsledok
3 10 20 30 false
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.