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

CKTIS / Java

Optional.isPresent() — verificar se existe um valor

Verifica se um `Optional` contém um valor sem o obter. Usa `isPresent()` quando precisas de um `boolean` e `ifPresent(...)` quando só queres agir sobre o valor caso exista.

Versão: Java SE 21

Sintaxe

public boolean isPresent()

// Call on an Optional<T> instance:
boolean hasValue = optional.isPresent();

Optional.isPresent é uma forma abreviada de referir o método Optional.isPresent(). É um método de instância sem argumentos de java.util.Optional<T>: chama-o como optional.isPresent(), não através de uma chamada estática sobre a classe.

Devolve um boolean: true se o Optional contiver um valor diferente de null e false se estiver vazio. Não devolve o valor contido nem altera o Optional. Até a cadeia de caracteres vazia "" conta como valor. Se a própria referência optional for null, a chamada lança NullPointerException em vez de devolver false.

Usa isPresent() quando precisares de uma condição, por exemplo numa instrução if. Para testar a ausência de um valor, optional.isEmpty() equivale a !optional.isPresent().

Se só queres imprimir o valor quando existe, usa optional.ifPresent(System.out::println) em vez de um if separado com uma chamada a get(). ifPresent(...) passa o valor à ação e não faz nada se o Optional estiver vazio. Chamar get() num Optional vazio lança NoSuchElementException.

Exemplos

import java.util.Optional;

public class Main {
    public static void main(String[] args) {
        Optional<String> found = Optional.of("Ada");
        Optional<String> missing = Optional.empty();

        System.out.println(found.isPresent());
        System.out.println(missing.isPresent());

        found.ifPresent(System.out::println);
        missing.ifPresent(System.out::println);
    }
}

Resultado

true
false
Ada

As duas primeiras linhas são os resultados de `isPresent()`: `true` e `false`. Só `found` contém um valor, por isso as duas chamadas a `ifPresent(...)` acrescentam apenas uma linha: `Ada`.

Lições relacionadas

  • Java · Lição 66 · Básico · Versão: 2
  • Java · Lição 47 · Intermédio · Versão: 2

Fontes