CKTIS / Java
Spliterator – procházení prvků a rozdělení práce
java.util.Spliterator umožňuje číst prvky a rozdělit zbývající rozsah. Vlastnosti zdroje popisují například pořadí a přesnost velikosti; samotné rozdělení nespouští paralelní provádění.
Verze: Java SE 21; repository runtime, production runtime not attested
Syntaxe
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> prochází prvky a rozděluje práci. Spliterator.tryAdvance(action) zpracuje jeden prvek a vrátí true, nebo po vyčerpání prvků vrátí false. Spliterator.forEachRemaining(action) zpracuje zbytek v aktuálním vlákně.
Spliterator.trySplit() oddělí disjunktní část, nebo vrátí null; nespouští žádné vlákno. Při Spliterator.ORDERED oddělí počáteční část a průchod zachovává pořadí prvků. Nesdílejte jednu instanci mezi vlákny, která pracují současně.
Spliterator.estimateSize() odhaduje počet prvků. Návratová hodnota Long.MAX_VALUE může znamenat, že velikost je neznámá, nekonečná nebo příliš nákladná na výpočet, ale může také udávat přesný konečný počet prvků. Spliterator.SIZED zaručuje přesnost před zahájením průchodu nebo dělení, pokud nedojde ke strukturálním změnám zdroje. Například v Javě 21 LongStream.range(0, Long.MAX_VALUE).spliterator() uvádí vlastnost SIZED a počáteční počet prvků je přesně Long.MAX_VALUE. Spliterator.SUBSIZED navíc zaručuje SIZED a SUBSIZED pro všechny potomky vzniklé dělením.
Spliterator.characteristics() vrací bitovou masku; Spliterator.hasCharacteristics(mask) kontroluje všechny požadované bity. Spliterator.NONNULL zaručuje, že žádné prvky nejsou null. Spliterator.IMMUTABLE vylučuje přidávání, nahrazování a odebírání prvků zdroje, ale neznamená neměnnost jejich polí.
Příklad používá Arrays.spliterator, který uvádí ORDERED, SIZED a SUBSIZED. Zpracuje oddělenou počáteční část před zbytkem, takže výsledek nezávisí na místě rozdělení. Během průchodu pole neměňte.
Příklady
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));
}
}Výsledek
4 true [A, B, C, D] false
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.