Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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`.

Fontes