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.