CKTIS / Java
AtomicLong.incrementAndGet(): Zähler erhöhen und neuen Wert zurückgeben
Die Methode erhöht einen `AtomicLong`-Zähler atomar um 1 und gibt den neuen `long`-Wert zurück, nicht den Wert vor der Erhöhung.
Version: Java SE 21
Syntax
public final long incrementAndGet()
// Call on an AtomicLong instance:
long next = counter.incrementAndGet();In Java SE 21 ist AtomicLong.incrementAndGet() eine Instanzmethode ohne Argumente der Klasse java.util.concurrent.atomic.AtomicLong. Sie erhöht den im Objekt gespeicherten Wert um 1 und gibt das Ergebnis als primitiven long zurück. Sie ist gleichbedeutend mit addAndGet(1L).
Auch getAndIncrement() erhöht den Wert atomar um 1, gibt aber den Wert vor der Änderung zurück. Bei incrementAndGet() bilden Lesen, Addieren und Schreiben eine atomare Operation: Gleichzeitige Erhöhungen desselben Zählers überschreiben einander nicht. Diese Garantie gilt nicht für den umgebenden Code: Getrennte Aufrufe von get() und set() bilden keine gemeinsame atomare Operation.
Wird Long.MAX_VALUE erhöht, springt der Zähler auf Long.MIN_VALUE. Die Methode gibt diesen Wert zurück und löst wegen des Überlaufs keine Ausnahme aus.
Beispiele
import java.util.concurrent.atomic.AtomicLong;
public class Main {
public static void main(String[] args) {
AtomicLong counter = new AtomicLong(1000L);
System.out.println(counter.incrementAndGet());
System.out.println(counter.incrementAndGet());
}
}Ergebnis
1001 1002
Der Zähler startet bei `1000L`. Zwei aufeinanderfolgende Aufrufe am selben Objekt liefern und drucken zuerst `1001` und dann `1002`.
Zugehörige Lektionen
- Java · Lektion 55 · Mittlere Stufe · Version: 2