WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

long — 64-Bit-Ganzzahl und die Long-Wrapperklasse

Der primitive Typ long speichert vorzeichenbehaftete 64-Bit-Ganzzahlen. Erfahre mehr über das Suffix L, den Unterschied zwischen long und Long sowie die Regeln für Wertgleichheit und Hashcodes.

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

Syntax

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

long ist ein Schlüsselwort für einen primitiven Typ: eine vorzeichenbehaftete 64-Bit-Ganzzahl im Zweierkomplement. Der Wertebereich reicht von -9223372036854775808 bis 9223372036854775807, also von -2^63 bis 2^63 - 1. Anders als der Referenztyp Long kann long nicht den Wert null annehmen.

Das Suffix L gibt einem Ganzzahlliteral den Typ long, nicht Long. Auch ein kleingeschriebenes l ist zulässig, aber L lässt sich leichter von der Ziffer 1 unterscheiden. Ohne Suffix hat ein Literal den Typ int: long value = 3_000_000_000; lässt sich nicht kompilieren; verwende 3_000_000_000L. Unterstriche zwischen Ziffern verbessern die Lesbarkeit.

Long ist eine unveränderliche Wrapperklasse für einen long-Wert; eine Instanz erhältst du mit Long.valueOf(value). Long.equals(Object) gibt genau dann true zurück, wenn das Argument ein Long-Objekt mit demselben Wert ist. Das gilt auch, wenn die Methode auf demselben Objekt aufgerufen wird, das als Argument übergeben wird. Daher ist Long.valueOf(42L).equals(Integer.valueOf(42)) gleich false. Bei zwei Long-Referenzen vergleicht == die Objektidentität, nicht die Werte.

Long.hashCode(long) gibt einen int-Hashcode zurück, der als (int)(value ^ (value >>> 32)) berechnet wird. Die Instanzmethode Long.hashCode() liefert für den verpackten Wert dasselbe Ergebnis. Gleiche Werte haben gleiche Hashcodes, aber übereinstimmende Hashcodes beweisen keine Gleichheit. Gewöhnliche Ganzzahloperationen melden keinen Überlauf; weist man das Ergebnis einer int-Berechnung einem long zu, wird ein bereits eingetretener Überlauf dadurch nicht behoben — verwende vor der Berechnung einen long-Operanden.

Beispiele

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

Ergebnis

3000000000
true
false
-1294967296
true

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen