CKTIS / Java
AtomicLong.incrementAndGet(): incrementar y devolver el valor nuevo
Incrementa un contador `AtomicLong` en 1 de forma atómica y devuelve el valor actualizado de tipo `long`, no el valor anterior.
Versión: Java SE 21
Sintaxis
public final long incrementAndGet()
// Call on an AtomicLong instance:
long next = counter.incrementAndGet();En Java SE 21, AtomicLong.incrementAndGet() es un método de instancia sin argumentos de java.util.concurrent.atomic.AtomicLong. Suma 1 al valor almacenado en el objeto y devuelve el resultado como un long primitivo. Equivale a addAndGet(1L).
getAndIncrement() también suma 1 de forma atómica, pero devuelve el valor anterior al cambio. Con incrementAndGet(), la lectura, la suma y la escritura forman una sola operación atómica: los incrementos concurrentes del mismo contador no se sobrescriben entre sí. Esta garantía no se extiende al código que rodea la llamada: las llamadas separadas a get() y set() no forman una sola operación atómica.
Al incrementar Long.MAX_VALUE, el contador pasa a Long.MIN_VALUE. El método devuelve ese valor y no lanza ninguna excepción por desbordamiento.
Ejemplos
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
El contador empieza en `1000L`. Dos llamadas consecutivas sobre el mismo objeto devuelven e imprimen `1001` y luego `1002`.
Lecciones relacionadas
- Java · Lección 55 · Intermedio · Versión: 2