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

CKTIS / Java

IntStream.allMatch(IntPredicate): verificar se todos os elementos cumprem uma condição

Verifica se todos os valores `int` de um fluxo cumprem uma condição e descobre por que razão um fluxo vazio devolve `true`.

Versão: Java SE 21

Sintaxe

boolean allMatch(IntPredicate predicate)

IntStream.allMatch(IntPredicate) é um método de instância de java.util.stream.IntStream. Requer um argumento do tipo java.util.function.IntPredicate, como n -> n % 2 == 0. O predicado recebe um int primitivo e devolve um boolean, sem ser necessário converter o valor num objeto Integer.

O método devolve true se todos os elementos cumprirem a condição e false se pelo menos um não a cumprir. Um fluxo vazio devolve true sem chamar o predicado: não há nenhum elemento que falhe o teste. Se os dados de entrada não puderem estar vazios, verifica isso separadamente.

É uma operação terminal com avaliação em curto-circuito. Basta um elemento que falhe o teste para determinar que o resultado é false, pelo que o método pode não testar todos os elementos. O predicado não deve modificar a fonte nem depender de um estado que mude. Não dependas de efeitos secundários como a contagem de chamadas ao predicado.

Depois de allMatch, o fluxo fica consumido, mesmo que nem todos os elementos tenham sido testados. Para verificar novamente os mesmos dados, cria um novo fluxo a partir da mesma fonte.

Exemplos

import java.util.function.IntPredicate;
import java.util.stream.IntStream;

public class Main {
    public static void main(String[] args) {
        IntPredicate isEven = n -> n % 2 == 0;

        System.out.println(IntStream.of(2, 4, 6).allMatch(isEven));
        System.out.println(IntStream.of(2, 3, 6).allMatch(isEven));
        System.out.println(IntStream.empty().allMatch(isEven));
    }
}

Resultado

true
false
true

`n % 2 == 0` verifica se o resto da divisão por `2` é zero. O primeiro fluxo só contém números pares (`true`), no segundo o `3` falha o teste (`false`) e o terceiro fluxo está vazio (`true`). Cada chamada usa um fluxo novo.

Lições relacionadas

  • Java · Lição 63 · Básico · Versão: 2

Fontes