CKTIS / Java
Spliterator – prehajanje elementov in razdelitev dela
java.util.Spliterator omogoča branje elementov in razdelitev preostalega obsega. Značilnosti vira opisujejo na primer vrstni red in natančnost velikosti; samo razdeljevanje ne zažene vzporednega izvajanja.
Različica: 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> prehaja elemente in razdeli delo. Spliterator.tryAdvance(action) obdela en element in vrne true ali pa vrne false, ko elementov zmanjka. Spliterator.forEachRemaining(action) obdela preostanek v trenutni niti.
Spliterator.trySplit() izloči disjunktni del ali vrne null; ne zažene nobene niti. Pri Spliterator.ORDERED izloči začetni del, prehajanje pa ohrani vrstni red elementov. Iste instance ne uporabljaj med nitmi, ki delujejo sočasno.
Spliterator.estimateSize() oceni število elementov. Vrnjena vrednost Long.MAX_VALUE lahko pomeni, da je velikost neznana, neskončna ali prezahtevna za izračun, lahko pa pomeni tudi točno, končno število elementov. Spliterator.SIZED zagotavlja natančnost, preden se začneta prehajanje ali razdeljevanje, če se struktura vira ne spremeni. V Javi 21 na primer LongStream.range(0, Long.MAX_VALUE).spliterator() navaja lastnost SIZED in ima na začetku natanko Long.MAX_VALUE elementov. Spliterator.SUBSIZED dodatno zagotavlja SIZED in SUBSIZED za vse potomce razdelitve.
Spliterator.characteristics() vrne bitno masko; Spliterator.hasCharacteristics(mask) preveri vse zahtevane bite. Spliterator.NONNULL zagotavlja, da ni elementov null. Spliterator.IMMUTABLE izključuje dodajanje, zamenjavo in odstranjevanje elementov vira, vendar njihovih polj ne naredi nespremenljivih.
Primer uporablja Arrays.spliterator, ki navaja ORDERED, SIZED in SUBSIZED. Najprej obdela izločeni začetni del, nato preostanek, zato rezultat ni odvisen od mesta razdelitve. Med prehajanjem ne spreminjaj polja.
Primeri
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.