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

CKTIS / Java

Predicate.or(): OU lógico entre predicados

Combina dois predicados numa condição reutilizável. O segundo predicado só é avaliado se o primeiro devolver `false`.

Versão: Java SE 21

Sintaxe

default Predicate<T> or(Predicate<? super T> other)

Predicate<T> combined = first.or(other);
boolean matches = combined.test(value);

Predicate.or() é um método predefinido da interface java.util.function.Predicate<T>. A chamada first.or(other) recebe um argumento e devolve um Predicate<T> sem testar qualquer valor. O parâmetro Predicate<? super T> aceita um predicado para T ou para um supertipo de T, por exemplo um Predicate<Object> quando first é um Predicate<String>.

Ao chamar combined.test(value), avalia-se primeiro first. Se devolver true, o resultado é true e other não é avaliado. Se devolver false, other testa o mesmo valor e fornece o resultado. O resultado só é false quando ambos os predicados devolvem false. A expressão first.test(value) || other.test(value) segue a mesma regra de avaliação em curto-circuito, mas produz um valor booleano em vez de um predicado reutilizável.

A chamada first.or(null) lança imediatamente uma NullPointerException, mesmo que first devolva sempre true. Isto é diferente de passar null a test: nesse caso, o comportamento depende dos predicados que forem de facto avaliados. Uma exceção lançada por qualquer um deles é propagada a quem fez a chamada; se first lançar uma exceção, other não é avaliado.

Exemplos

import java.util.function.Predicate;

public class Main {
    public static void main(String[] args) {
        Predicate<String> startsWithA = name -> name.startsWith("A");
        Predicate<String> atLeastFive = name -> {
            System.out.println("length check: " + name);
            return name.length() >= 5;
        };

        Predicate<String> matches = startsWithA.or(atLeastFive);
        for (String name : new String[] {"Amy", "Bruno", "Bo"}) {
            System.out.println(name + ": " + matches.test(name));
        }
    }
}

Resultado

Amy: true
length check: Bruno
Bruno: true
length check: Bo
Bo: false

`Amy` satisfaz a primeira condição, por isso `length check: Amy` não aparece. O comprimento é verificado para `Bruno` e `Bo`: `Bruno` satisfaz a condição porque tem pelo menos cinco caracteres, mas `Bo` não.

Lições relacionadas

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

Fontes