CKTIS / C
atomic_fetch_sub — función genérica atómica de C23
`atomic_fetch_sub(object, operand)` de `<stdatomic.h>` resta atómicamente `operand` de un objeto entero o puntero atómico y devuelve el valor anterior. Es una única operación read-modify-write.
Versión: C23
Sintaxis
C atomic_fetch_sub(volatile A *object, M operand);atomic_fetch_sub(object, operand) de <stdatomic.h> resta atómicamente operand de un objeto entero o puntero atómico y devuelve el valor anterior. Es una única operación read-modify-write.
Sirve para reducir un contador compartido sin actualizaciones perdidas cuando el valor antiguo participa en una decisión. El ejemplo resta realmente 6 de 20: devuelve el anterior 20 y el estado posterior es 14.
La forma sin _explicit usa memory_order_seq_cst y no tiene que ser lock-free. No satura en cero: la aritmética entera atómica con signo usa complemento a dos sin desbordamiento indefinido, la no signada envuelve módulo; para un puntero atómico el operando es ptrdiff_t y el resultado puede ser una dirección inválida. 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 remaining = 20;
int previous = atomic_fetch_sub(&remaining, 6);
printf("%d %d\n", previous, atomic_load(&remaining));
return 0;
}
Resultado
20 14
Sirve para reducir un contador compartido sin actualizaciones perdidas cuando el valor antiguo participa en una decisión. El ejemplo resta realmente `6` de `20`: devuelve el anterior `20` y el estado posterior es `14`.