Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

IntStream — filtrar e agregar valores int

IntStream processa valores primitivos int. Permite filtrar dados, testar condições e calcular o número de elementos, a soma e a média.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

IntStream.of(int... values)
IntStream filter(IntPredicate predicate)
boolean allMatch(IntPredicate predicate)
long count()
int sum()
OptionalDouble average()

java.util.stream.IntStream é um fluxo de valores primitivos int, não de objetos Integer. Descreve o processamento de dados, mas não os armazena como uma coleção. IntStream.of(int) cria um fluxo com um elemento, enquanto IntStream.of(int... values) cria um fluxo sequencial e ordenado dos valores fornecidos; também aceita int[].

IntStream.filter(IntPredicate) mantém os elementos que correspondem ao predicado. É uma operação intermédia preguiçosa: chamá-la, por si só, não executa a filtragem. O predicado deve ser sem estado e não modificar a origem.

IntStream.allMatch(IntPredicate) devolve boolean e pode terminar a verificação antecipadamente; devolve true para um fluxo vazio. IntStream.count() devolve long, enquanto IntStream.sum() devolve int; ambos devolvem 0 para um fluxo vazio. IntStream.average() devolve um OptionalDouble, vazio quando não existem elementos.

Estas quatro operações são terminais. Não reutilize um fluxo depois de uma operação terminal: crie outro a partir da origem. O exemplo faz isso para cada cálculo. orElse(0.0) escolhe explicitamente um valor alternativo para uma média vazia.

Exemplos

import java.util.stream.IntStream;

public class Main {
    public static void main(String[] args) {
        int[] values = {1, 2, 3, 4};
        boolean positive = IntStream.of(values).allMatch(n -> n > 0);
        long evenCount = IntStream.of(values).filter(n -> n % 2 == 0).count();
        int sum = IntStream.of(values).sum();
        double average = IntStream.of(values).average().orElse(0.0);

        System.out.println("positive=" + positive);
        System.out.println("evenCount=" + evenCount);
        System.out.println("sum=" + sum);
        System.out.println("average=" + average);
    }
}

Resultado

positive=true
evenCount=2
sum=10
average=2.5

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes