Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti