CKTIS / Java
long — inteiro de 64 bits e classe wrapper Long
O tipo primitivo long armazena inteiros com sinal de 64 bits. Conheça o sufixo L, a diferença entre long e Long e as regras de igualdade de valores e códigos hash.
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
long value = 3_000_000_000L; Long boxed = Long.valueOf(value);long é uma palavra-chave que designa um tipo primitivo: um inteiro com sinal de 64 bits em complemento para dois. O intervalo vai de -9223372036854775808 a 9223372036854775807, ou seja, de -2^63 a 2^63 - 1. Ao contrário do tipo de referência Long, long não pode conter null.
O sufixo L atribui a um literal inteiro o tipo long, e não Long. Também é válido o l minúsculo, mas L distingue-se mais facilmente do algarismo 1. Sem sufixo, um literal é do tipo int: long value = 3_000_000_000; não compila; utiliza 3_000_000_000L. Os underscores entre algarismos melhoram a legibilidade.
Long é uma classe wrapper imutável para um valor long; obtém-se uma instância com Long.valueOf(value). Long.equals(Object) devolve true se e só se o argumento for um objeto Long com o mesmo valor, incluindo quando é o próprio objeto sobre o qual o método é chamado. Por isso, Long.valueOf(42L).equals(Integer.valueOf(42)) devolve false. Entre duas referências Long, == compara a identidade dos objetos, não os valores.
Long.hashCode(long) devolve um código hash do tipo int, calculado como (int)(value ^ (value >>> 32)). O método de instância Long.hashCode() produz o mesmo resultado para o valor encapsulado. Valores iguais têm códigos hash iguais, mas códigos coincidentes não provam a igualdade. As operações inteiras habituais não assinalam overflow; atribuir a long o resultado de um cálculo do tipo int não corrige um overflow anterior — utiliza um operando long antes do cálculo.
Exemplos
public class Main {
public static void main(String[] args) {
long value = 3_000_000_000L;
Long boxed = Long.valueOf(value);
System.out.println(value);
System.out.println(boxed.equals(Long.valueOf(value)));
System.out.println(Long.valueOf(42L).equals(Integer.valueOf(42)));
System.out.println(Long.hashCode(value));
System.out.println(boxed.hashCode() == Long.hashCode(value));
}
}Resultado
3000000000 true false -1294967296 true
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.