Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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

Fuentes