Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

AtomicLong.incrementAndGet(): incrementare e restituire il nuovo valore

Incrementa un contatore `AtomicLong` di 1 in modo atomico e restituisce il valore `long` aggiornato, non quello precedente.

Versione: Java SE 21

Sintassi

public final long incrementAndGet()

// Call on an AtomicLong instance:
long next = counter.incrementAndGet();

In Java SE 21, AtomicLong.incrementAndGet() è un metodo di istanza senza argomenti di java.util.concurrent.atomic.AtomicLong. Aggiunge 1 al valore memorizzato nell’oggetto e restituisce il risultato come long primitivo. Equivale a addAndGet(1L).

Anche getAndIncrement() aggiunge 1 in modo atomico, ma restituisce il valore precedente alla modifica. Con incrementAndGet(), lettura, somma e scrittura costituiscono un’unica operazione atomica: gli incrementi concorrenti dello stesso contatore non si sovrascrivono a vicenda. Questa garanzia non si estende al codice circostante: chiamate separate a get() e set() non costituiscono un’unica operazione atomica.

Se si incrementa Long.MAX_VALUE, il contatore passa a Long.MIN_VALUE. Il metodo restituisce quel valore e non genera un’eccezione per l’overflow.

Esempi

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

Risultato

1001
1002

Il contatore parte da `1000L`. Due chiamate consecutive sullo stesso oggetto restituiscono e stampano prima `1001` e poi `1002`.

Lezioni correlate

  • Java · Lezione 55 · Intermedio · Versione: 2

Fonti