CKTIS / C
atomic_fetch_sub — função genérica atómica C23
`atomic_fetch_sub(object, operand)` de `<stdatomic.h>` subtrai atomicamente `operand` de um objeto inteiro ou ponteiro atómico e devolve o valor anterior. É uma única operação read-modify-write.
Versão: C23
Sintaxe
C atomic_fetch_sub(volatile A *object, M operand);atomic_fetch_sub(object, operand) de <stdatomic.h> subtrai atomicamente operand de um objeto inteiro ou ponteiro atómico e devolve o valor anterior. É uma única operação read-modify-write.
Serve para diminuir contador partilhado sem atualizações perdidas quando o valor antigo é necessário para uma decisão. O exemplo subtrai realmente 6 de 20: devolve o anterior 20 e o estado posterior é 14.
A forma sem _explicit usa memory_order_seq_cst e pode não ser lock-free. Não satura em zero: a aritmética inteira atómica com sinal usa complemento para dois sem overflow indefinido, a sem sinal roda módulo; para ponteiro atómico o operando é ptrdiff_t e o resultado pode ser endereço inválido. A expressão «tipo inteiro atómico» exclui explicitamente _Atomic bool; a forma especificada separadamente para ponteiros atómicos continua permitida.
O nome desta função genérica pode ser uma macro ou um identificador externo; suprimir a macro para chamar uma função real ou definir um identificador externo com esse nome tem comportamento indefinido.
Exemplos
#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
Serve para diminuir contador partilhado sem atualizações perdidas quando o valor antigo é necessário para uma decisão. O exemplo subtrai realmente `6` de `20`: devolve o anterior `20` e o estado posterior é `14`.