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

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

Sources