Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

AtomicLong.incrementAndGet(): incrementar e devolver o novo valor

Incrementa um contador `AtomicLong` em 1 de forma atómica e devolve o valor atualizado do tipo `long`, não o valor anterior.

Versão: Java SE 21

Sintaxe

public final long incrementAndGet()

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

Em Java SE 21, AtomicLong.incrementAndGet() é um método de instância sem argumentos de java.util.concurrent.atomic.AtomicLong. Adiciona 1 ao valor guardado no objeto e devolve o resultado como um long primitivo. Equivale a addAndGet(1L).

getAndIncrement() também adiciona 1 de forma atómica, mas devolve o valor anterior à alteração. Em incrementAndGet(), a leitura, a adição e a escrita formam uma única operação atómica: os incrementos concorrentes do mesmo contador não se sobrepõem uns aos outros. Esta garantia não se estende ao código envolvente: chamadas separadas a get() e a set() não formam uma única operação atómica.

Ao incrementar Long.MAX_VALUE, o contador passa para Long.MIN_VALUE. O método devolve esse valor e não lança nenhuma exceção por transbordo.

Exemplos

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

Resultado

1001
1002

O contador começa em `1000L`. Duas chamadas consecutivas sobre o mesmo objeto devolvem e imprimem `1001` e depois `1002`.

Lições relacionadas

  • Java · Lição 55 · Intermédio · Versão: 2

Fontes