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

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.

Fontes