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

CKTIS / Java

OptionalDouble: valor alternativo ou obtenção do valor

OptionalDouble representa um valor double ou a sua ausência. Descubra a diferença entre orElse e getAsDouble.

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

Sintaxe

double orElse(double other)
double getAsDouble()

OptionalDouble contém um valor double ou está vazio. Crie estes estados com OptionalDouble.of(value) e OptionalDouble.empty(). A própria referência não deve ser null.

OptionalDouble.orElse(other) devolve o valor armazenado ou, se o contentor estiver vazio, other. OptionalDouble.getAsDouble() devolve o valor, mas lança NoSuchElementException quando o contentor está vazio.

Escolha orElse quando for aceitável usar um valor alternativo. Antes de usar getAsDouble(), certifique-se de que existe um valor. A documentação Java SE 21 recomenda orElseThrow() em vez de getAsDouble().

Exemplos

import java.util.NoSuchElementException;
import java.util.OptionalDouble;

public class Main {
    public static void main(String[] args) {
        OptionalDouble present = OptionalDouble.of(2.5);
        OptionalDouble empty = OptionalDouble.empty();

        System.out.println(present.orElse(1.0));
        System.out.println(empty.orElse(1.0));
        System.out.println(present.getAsDouble());
        try {
            empty.getAsDouble();
        } catch (NoSuchElementException exception) {
            System.out.println("NoSuchElementException");
        }
    }
}

Resultado

2.5
1.0
2.5
NoSuchElementException

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