Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

long — entier 64 bits et classe enveloppe Long

Le type primitif long stocke des entiers signés sur 64 bits. Découvrez le suffixe L, la différence entre long et Long, ainsi que les règles d’égalité des valeurs et de calcul des codes de hachage.

Version : Java SE 21; repository runtime, production runtime not attested

Syntaxe

long value = 3_000_000_000L; Long boxed = Long.valueOf(value);

long est un mot-clé qui désigne un type primitif : un entier signé sur 64 bits en complément à deux. Sa plage va de -9223372036854775808 à 9223372036854775807, soit de -2^63 à 2^63 - 1. Contrairement au type référence Long, long ne peut pas contenir null.

Le suffixe L donne à un littéral entier le type long, et non Long. La lettre l minuscule est aussi valide, mais L se distingue plus facilement du chiffre 1. Sans suffixe, un littéral est de type int : long value = 3_000_000_000; ne compile pas ; utilisez 3_000_000_000L. Les traits de soulignement entre les chiffres améliorent la lisibilité.

Long est une classe enveloppe immuable pour une valeur long ; créez une instance avec Long.valueOf(value). Long.equals(Object) renvoie true si et seulement si l’argument est un objet Long de même valeur, y compris s’il s’agit de l’objet sur lequel la méthode est appelée. Ainsi, Long.valueOf(42L).equals(Integer.valueOf(42)) renvoie false. Entre deux références Long, == compare l’identité des objets, et non leurs valeurs.

Long.hashCode(long) renvoie un code de hachage de type int, calculé comme (int)(value ^ (value >>> 32)). La méthode d’instance Long.hashCode() produit le même résultat pour la valeur enveloppée. Des valeurs égales ont des codes de hachage égaux, mais des codes identiques ne prouvent pas l’égalité. Les opérations entières ordinaires ne signalent pas les dépassements ; affecter à long le résultat d’un calcul de type int ne répare pas un dépassement antérieur — utilisez un opérande long avant le calcul.

Exemples

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));
    }
}

Résultat

3000000000
true
false
-1294967296
true

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources