CKTIS / Java
util.OptionalLong: referência prática
util.OptionalLong: referência prática: OptionalLong guarda um long primitivo presente ou o estado empty sem boxing para Long.
Versão: Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime
Sintaxe
java.util.OptionalLongOptionalLong guarda um long primitivo presente ou o estado empty sem boxing para Long.
Usa-o para contadores, timestamps ou tamanhos opcionais quando todo o intervalo long continua a ser dado válido.
Não trates empty como zero nem chames getAsLong sem verificar isPresent; a ausência causa NoSuchElementException.
orElseGet chama LongSupplier apenas quando empty, ifPresentOrElse escolhe exatamente um ramo e stream contém zero ou um long.
O exemplo exercita o elemento documentado num programa pequeno e determinístico e compara exatamente a saída padrão.
Exemplos
public class Main {
public static void main(String[] args) throws Exception {
var value = java.util.OptionalLong.empty();
System.out.println(value.orElse(42));
}
}
Resultado
42
O exemplo exercita o elemento documentado num programa pequeno e determinístico e compara exatamente a saída padrão.