CKTIS / Java
Spliterator — attraversare gli elementi e suddividere il lavoro
java.util.Spliterator consente di leggere gli elementi e suddividere l’intervallo rimanente. Le caratteristiche della sorgente descrivono, tra l’altro, l’ordine e la precisione della dimensione; la sola suddivisione non avvia un’esecuzione parallela.
Versione: Java SE 21; repository runtime, production runtime not attested
Sintassi
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> attraversa gli elementi e suddivide il lavoro. Spliterator.tryAdvance(action) elabora un elemento e restituisce true, oppure restituisce false quando gli elementi sono esauriti. Spliterator.forEachRemaining(action) elabora il resto nel thread corrente.
Spliterator.trySplit() separa una parte disgiunta oppure restituisce null; non avvia alcun thread. Con Spliterator.ORDERED, separa un prefisso e l’attraversamento mantiene l’ordine di incontro. Non condividere la stessa istanza tra thread che operano contemporaneamente.
Spliterator.estimateSize() stima il numero di elementi. Il valore restituito Long.MAX_VALUE può indicare che la dimensione è sconosciuta, infinita o troppo costosa da calcolare, ma può anche essere un numero esatto e finito di elementi. Spliterator.SIZED garantisce l’esattezza prima che inizi l’attraversamento o la suddivisione, purché la struttura della sorgente non cambi. Per esempio, in Java 21, LongStream.range(0, Long.MAX_VALUE).spliterator() dichiara SIZED e ha una dimensione iniziale pari esattamente a Long.MAX_VALUE elementi. Spliterator.SUBSIZED garantisce inoltre SIZED e SUBSIZED per tutti i discendenti delle suddivisioni.
Spliterator.characteristics() restituisce una maschera di bit; Spliterator.hasCharacteristics(mask) controlla tutti i bit richiesti. Spliterator.NONNULL garantisce che non ci siano elementi null. Spliterator.IMMUTABLE esclude l’aggiunta, la sostituzione e la rimozione di elementi dalla sorgente, ma non rende immutabili i loro campi.
L’esempio usa Arrays.spliterator, che dichiara ORDERED, SIZED e SUBSIZED. Elabora il prefisso separato prima del resto, quindi il risultato non dipende dal punto di suddivisione. Non modificare l’array durante l’attraversamento.
Esempi
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));
}
}Risultato
4 true [A, B, C, D] false
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.