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

CKTIS / Java

IntStream.count — contar os elementos de um fluxo

IntStream.count() devolve o número de elementos como long, não a soma dos respetivos valores. É uma operação terminal que conta os elementos restantes após operações anteriores, como filter.

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

Sintaxe

long count = intStream.count();

IntStream.count() não recebe argumentos e devolve um long, embora os elementos do fluxo sejam do tipo int. Num fluxo vazio, o resultado é 0. Os valores repetidos são contados separadamente: o método não remove duplicados nem soma os valores.

É uma operação terminal que conclui o pipeline. Conta os elementos após operações intermédias anteriores, como filter. Não reutilizes o mesmo fluxo depois; cria um novo para outro cálculo. Não apliques count() a um fluxo infinito sem limites à espera que termine.

A implementação pode calcular o número sem percorrer os elementos se conhecer o tamanho da origem. Nesse caso, pode ignorar operações intermédias, por isso não dependas de efeitos secundários em peek ou map.

No exemplo, filter mantém 2, 4, 4, pelo que o resultado é 3. As duas ocorrências de 4 são contadas separadamente.

Exemplos

import java.util.stream.IntStream;

public class Main {
    public static void main(String[] args) {
        long count = IntStream.of(2, 3, 4, 4, 7)
                .filter(n -> n % 2 == 0)
                .count();
        System.out.println(count);
    }
}

Resultado

3

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