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

CKTIS / Java

O sufixo `L` dos literais inteiros em Java

`0L` é zero do tipo `long`, enquanto `0` é zero do tipo `int`. A diferença afeta a escolha da sobrecarga, os cálculos e os valores predefinidos do tipo `Long`.

Versão: Java SE 21

Sintaxe

IntegerLiteral:
    DecimalNumeral [IntegerTypeSuffix]
    HexNumeral [IntegerTypeSuffix]
    OctalNumeral [IntegerTypeSuffix]
    BinaryNumeral [IntegerTypeSuffix]

IntegerTypeSuffix: L | l

Em Java SE 21, um literal inteiro válido sem sufixo tem o tipo int; com L ou l, tem o tipo long. Escreve o sufixo logo após o último algarismo do numeral decimal, hexadecimal, octal ou binário. Prefere L maiúsculo, porque o l minúsculo é fácil de confundir com 1. 0L e 0 têm o mesmo valor, mas tipos diferentes.

long timeout = 0; funciona graças a uma conversão de alargamento de int para long; long timeout = 0L; usa diretamente um literal long. O tipo de destino não corrige um literal demasiado grande: 2_147_483_648 numa atribuição dá um erro de compilação, ao passo que 2_147_483_648L é válido. Sem L, essa magnitude decimal só é permitida logo após o menos unário (-2147483648); a exceção equivalente para long é -9223372036854775808L.

Quando existem kind(int) e kind(long), kind(0) chama a sobrecarga int e kind(0L) chama a sobrecarga long. Em 1_000_000 * 3_000, a multiplicação é feita em int e ocorre um overflow, mesmo que o resultado seja atribuído a um long. Em 1_000_000L * 3_000, Java promove o outro operando para long antes da multiplicação. Também pode ocorrer overflow com long.

Num Map<String, Long>, o segundo argumento de getOrDefault tem de ser compatível com Long: 0L é convertido por boxing em Long, enquanto 0 seria convertido em Integer. Nesta chamada, Java não combina o alargamento de int para long com o boxing para Long. O método só usa o valor predefinido se a chave não estiver associada a um valor no mapa.

Exemplos

import java.util.Map;

public class IntegerLiteralSuffixDemo {
    static String kind(int value) { return "int"; }
    static String kind(long value) { return "long"; }

    public static void main(String[] args) {
        long timeout = 0L;
        Map<String, Long> timeouts = Map.of("read", 2_147_483_648L);
        Long missing = timeouts.getOrDefault("write", 0L);

        System.out.println("timeout=" + timeout);
        System.out.println("kind(0)=" + kind(0));
        System.out.println("kind(0L)=" + kind(0L));
        System.out.println("read=" + timeouts.getOrDefault("read", 0L));
        System.out.println("write=" + missing);
        System.out.println("int product=" + (1_000_000 * 3_000));
        System.out.println("long product=" + (1_000_000L * 3_000));
    }
}

Resultado

timeout=0
kind(0)=int
kind(0L)=long
read=2147483648
write=0
int product=-1294967296
long product=3000000000

O mapa não contém a chave `write`, pelo que o método devolve `0`. As duas últimas linhas mostram o produto `int` com overflow e o produto `long` correto.

Lições relacionadas

  • Java · Lição 30 · Avançado · Versão: 2
  • Java · Lição 31 · Avançado · Versão: 2
  • Java · Lição 43 · Avançado · Versão: 2

Fontes