Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

AtomicLong.incrementAndGet(): zwiększenie licznika i zwrócenie nowej wartości

Metoda atomowo zwiększa wartość licznika `AtomicLong` o 1 i zwraca nową wartość typu `long`, a nie tę sprzed zwiększenia.

Wersja: Java SE 21

Składnia

public final long incrementAndGet()

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

W Java SE 21 AtomicLong.incrementAndGet() to bezargumentowa metoda instancji klasy java.util.concurrent.atomic.AtomicLong. Zwiększa wartość przechowywaną w obiekcie o 1 i zwraca wynik jako prymitywny long. Działa tak samo jak addAndGet(1L).

getAndIncrement() również atomowo zwiększa wartość o 1, ale zwraca wartość sprzed zmiany. W incrementAndGet() odczyt, dodanie i zapis tworzą jedną operację atomową: równoczesne zwiększenia tego samego licznika nie nadpisują się nawzajem. Ta gwarancja nie obejmuje otaczającego kodu: osobne wywołania get() i set() nie tworzą razem jednej operacji atomowej.

Przy zwiększeniu Long.MAX_VALUE licznik przechodzi do Long.MIN_VALUE. Metoda zwraca tę wartość i nie zgłasza wyjątku z powodu przepełnienia.

Przykłady

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

Wynik

1001
1002

Licznik zaczyna od `1000L`. Dwa kolejne wywołania na tym samym obiekcie zwracają i wypisują `1001`, a następnie `1002`.

Powiązane lekcje

  • Java · Lekcja 55 · Średniozaawansowany · Wersja: 2

Źródła