CKTIS / Java
Spliterator — prolazak kroz elemente i podjela posla
java.util.Spliterator omogućuje čitanje elemenata i podjelu preostalog raspona. Svojstva izvora opisuju, među ostalim, redoslijed i točnost veličine; sama podjela ne pokreće paralelno izvođenje.
Verzija: Java SE 21; repository runtime, production runtime not attested
Sintaksa
Spliterator<T> s = Arrays.spliterator(array);
boolean advanced = s.tryAdvance(action);
Spliterator<T> prefix = s.trySplit();
long estimate = s.estimateSize();
int flags = s.characteristics();
boolean sized = s.hasCharacteristics(Spliterator.SIZED);
s.forEachRemaining(action);java.util.Spliterator<T> prolazi kroz elemente i dijeli posao. Spliterator.tryAdvance(action) obrađuje jedan element i vraća true ili vraća false kada ponestane elemenata. Spliterator.forEachRemaining(action) obrađuje ostatak u trenutačnoj dretvi.
Spliterator.trySplit() izdvaja disjunktni dio ili vraća null; ne pokreće nijednu dretvu. Uz Spliterator.ORDERED izdvaja početni dio, a prolazak čuva redoslijed elemenata. Nemoj dijeliti istu instancu između dretvi koje rade istodobno.
Spliterator.estimateSize() procjenjuje broj elemenata. Povratna vrijednost Long.MAX_VALUE može značiti da je veličina nepoznata, beskonačna ili preskupa za izračun, ali može biti i točan konačan broj elemenata. Spliterator.SIZED jamči točnost prije početka prolaska ili podjele, pod uvjetom da nema strukturnih promjena izvora. Na primjer, u Javi 21 LongStream.range(0, Long.MAX_VALUE).spliterator() navodi svojstvo SIZED i početni broj elemenata iznosi točno Long.MAX_VALUE. Spliterator.SUBSIZED dodatno jamči SIZED i SUBSIZED za sve potomke podjele.
Spliterator.characteristics() vraća bitnu masku; Spliterator.hasCharacteristics(mask) provjerava sve tražene bitove. Spliterator.NONNULL jamči da nema elemenata null. Spliterator.IMMUTABLE isključuje dodavanje, zamjenu i uklanjanje elemenata izvora, ali ne čini njihova polja nepromjenjivima.
Primjer upotrebljava Arrays.spliterator, koji navodi ORDERED, SIZED i SUBSIZED. Obrađuje izdvojeni početni dio prije ostatka, pa rezultat ne ovisi o mjestu podjele. Ne mijenjaj polje tijekom prolaska.
Primjeri
import java.util.ArrayList;
import java.util.Arrays;
import java.util.List;
import java.util.Spliterator;
public class Main {
public static void main(String[] args) {
Spliterator<String> rest = Arrays.spliterator(
new String[]{"A", "B", "C", "D"});
System.out.println(rest.estimateSize());
System.out.println(rest.hasCharacteristics(
Spliterator.ORDERED | Spliterator.SIZED | Spliterator.SUBSIZED));
Spliterator<String> prefix = rest.trySplit();
List<String> visited = new ArrayList<>();
if (prefix != null) {
prefix.tryAdvance(visited::add);
prefix.forEachRemaining(visited::add);
}
rest.forEachRemaining(visited::add);
System.out.println(visited);
System.out.println(rest.tryAdvance(visited::add));
}
}Rezultat
4 true [A, B, C, D] false
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.