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 | lEm 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
- Java Language Specification, Java SE 21 — §3.10.1 Integer Literals
- Java Language Specification, Java SE 21 — §5.2 Assignment Contexts
- Java Language Specification, Java SE 21 — §5.3 Invocation Contexts
- Java Language Specification, Java SE 21 — §5.6 Numeric Contexts
- Java Language Specification, Java SE 21 — §15.12.2 Compile-Time Step 2: Determine Method Signature
- Java Language Specification, Java SE 21 — §15.17.1 Multiplication Operator *
- Java SE 21 API — Map.getOrDefault(Object, V)