Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

DoubleStream — filtrare, contare e calcolare la media

DoubleStream elabora valori primitivi double in una pipeline lazy. Scopri come creare uno stream, filtrarlo e usare le operazioni terminali count() e average().

Versione: Java SE 21; repository runtime, production runtime not attested

Sintassi

static DoubleStream of(double t)
static DoubleStream of(double... values)
DoubleStream filter(DoublePredicate predicate)
long count()
OptionalDouble average()

java.util.stream.DoubleStream è uno stream di valori primitivi double, non di oggetti Double come in Stream<Double>. Non memorizza i dati: ne descrive l’elaborazione. DoubleStream.of(double t) crea uno stream sequenziale con un solo elemento, mentre DoubleStream.of(double... values) crea uno stream sequenziale e ordinato dei valori forniti.

DoubleStream.filter(DoublePredicate predicate) è un’operazione intermedia lazy: conserva i valori che soddisfano la condizione. Il predicato dovrebbe essere stateless e non deve modificare la sorgente. Un’operazione terminale avvia l’elaborazione. DoubleStream.count() restituisce il numero di elementi come long; uno stream vuoto produce 0.

DoubleStream.average() è un’operazione terminale che restituisce la media aritmetica in un OptionalDouble. Uno stream vuoto produce un risultato opzionale vuoto, non una media pari a zero. orElse(-1.0) seleziona esplicitamente un valore di ripiego. I calcoli in virgola mobile possono comportare arrotondamenti; la media può anche essere NaN.

Dopo un’operazione terminale, la pipeline è consumata: non chiamare count() e average() sullo stesso stream. L’esempio crea due stream distinti. Dopo il filtraggio restano 2.0, 4.0 e 6.0, quindi i risultati attesi sono 3 e 4.0.

Esempi

import java.util.OptionalDouble;
import java.util.stream.DoubleStream;

public class Main {
    public static void main(String[] args) {
        long count = DoubleStream.of(1.0, 2.0, 4.0, 6.0)
                .filter(x -> x >= 2.0)
                .count();

        OptionalDouble average = DoubleStream.of(1.0, 2.0, 4.0, 6.0)
                .filter(x -> x >= 2.0)
                .average();

        System.out.println("count=" + count);
        System.out.println("average=" + average.orElse(-1.0));
    }
}

Risultato

count=3
average=4.0

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