CKTIS / Java
AtomicLong.incrementAndGet(): zvýšení čítače a vrácení nové hodnoty
Metoda atomicky zvýší hodnotu čítače `AtomicLong` o 1 a vrátí novou hodnotu typu `long`, nikoli hodnotu před zvýšením.
Verze: Java SE 21
Syntaxe
public final long incrementAndGet()
// Call on an AtomicLong instance:
long next = counter.incrementAndGet();V Java SE 21 je AtomicLong.incrementAndGet() instanční metoda bez argumentů třídy java.util.concurrent.atomic.AtomicLong. K hodnotě uložené v objektu přičte 1 a vrátí výsledek jako primitivní long. Je ekvivalentní volání addAndGet(1L).
getAndIncrement() také atomicky přičte 1, ale vrátí hodnotu před změnou. U incrementAndGet() tvoří čtení, přičtení a zápis jedinou atomickou operaci: souběžná zvýšení téhož čítače se navzájem nepřepisují. Tato záruka se nevztahuje na okolní kód: samostatná volání get() a set() netvoří jedinou atomickou operaci.
Při zvýšení hodnoty Long.MAX_VALUE čítač přejde na Long.MIN_VALUE. Metoda tuto hodnotu vrátí a při přetečení nevyvolá výjimku.
Příklady
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());
}
}Výsledek
1001 1002
Čítač začíná na `1000L`. Dvě po sobě jdoucí volání na stejném objektu vrátí a vypíšou nejprve `1001` a poté `1002`.
Související lekce
- Java · Lekce 55 · Středně pokročilá · Verze: 2