CKTIS / Java
AtomicLong.incrementAndGet() : incrémenter et renvoyer la nouvelle valeur
La méthode incrémente un compteur `AtomicLong` de 1 de façon atomique et renvoie la nouvelle valeur de type `long`, pas l’ancienne.
Version : Java SE 21
Syntaxe
public final long incrementAndGet()
// Call on an AtomicLong instance:
long next = counter.incrementAndGet();Dans Java SE 21, AtomicLong.incrementAndGet() est une méthode d’instance sans argument de java.util.concurrent.atomic.AtomicLong. Elle ajoute 1 à la valeur stockée dans l’objet et renvoie le résultat sous forme de long primitif. Elle équivaut à addAndGet(1L).
getAndIncrement() ajoute également 1 de façon atomique, mais renvoie la valeur avant la modification. Avec incrementAndGet(), la lecture, l’addition et l’écriture forment une seule opération atomique : les incréments concurrents du même compteur ne s’écrasent pas mutuellement. Cette garantie ne s’étend pas au code environnant : des appels distincts à get() et à set() ne forment pas une seule opération atomique.
Incrémenter Long.MAX_VALUE fait passer le compteur à Long.MIN_VALUE. La méthode renvoie cette valeur sans lever d’exception en cas de dépassement.
Exemples
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());
}
}Résultat
1001 1002
Le compteur part de `1000L`. Deux appels successifs sur le même objet renvoient et affichent `1001`, puis `1002`.
Leçons associées
- Java · Leçon 55 · Intermédiaire · Version : 2