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