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

CKTIS / C

atomic_fetch_add — función genérica atómica de C23

`atomic_fetch_add(object, operand)` de `<stdatomic.h>` suma atómicamente `operand` a un objeto entero o puntero atómico y devuelve el valor anterior a la suma. Es una única operación read-modify-write.

Versión: C23

Sintaxis

C atomic_fetch_add(volatile A *object, M operand);

atomic_fetch_add(object, operand) de <stdatomic.h> suma atómicamente operand a un objeto entero o puntero atómico y devuelve el valor anterior a la suma. Es una única operación read-modify-write.

Sirve para asignar números de secuencia únicos o incrementar un contador compartido sin actualizaciones perdidas. El ejemplo suma realmente 3 a 10: devuelve el ticket anterior 10 y el estado posterior es 13.

La forma sin _explicit usa memory_order_seq_cst, pero no tiene que ser lock-free. Para enteros atómicos, la aritmética con signo usa complemento a dos sin resultado de desbordamiento indefinido; para un puntero atómico el operando es ptrdiff_t y el resultado puede ser una dirección inválida. Siempre devuelve el valor antiguo. La expresión «tipo entero atómico» excluye explícitamente _Atomic bool; la forma especificada por separado para punteros atómicos sigue permitida.

El nombre de esta función genérica puede ser una macro o un identificador externo; suprimir la macro para llamar a una función real o definir un identificador externo con ese nombre tiene comportamiento indefinido.

Ejemplos

#include <stdatomic.h>
#include <stdio.h>

int main(void) {
    atomic_int tickets = 10;
    int previous = atomic_fetch_add(&tickets, 3);
    printf("%d %d\n", previous, atomic_load(&tickets));
    return 0;
}

Resultado

10 13

Sirve para asignar números de secuencia únicos o incrementar un contador compartido sin actualizaciones perdidas. El ejemplo suma realmente `3` a `10`: devuelve el ticket anterior `10` y el estado posterior es `13`.

Fuentes