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

CKTIS / C

atomic_fetch_add — função genérica atómica C23

`atomic_fetch_add(object, operand)` de `<stdatomic.h>` soma atomicamente `operand` a um objeto inteiro ou ponteiro atómico e devolve o valor anterior à soma. É uma única operação read-modify-write.

Versão: C23

Sintaxe

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

atomic_fetch_add(object, operand) de <stdatomic.h> soma atomicamente operand a um objeto inteiro ou ponteiro atómico e devolve o valor anterior à soma. É uma única operação read-modify-write.

Serve para atribuir números sequenciais únicos ou incrementar contador partilhado sem atualizações perdidas. O exemplo soma realmente 3 a 10: devolve o bilhete antigo 10 e o estado posterior é 13.

A forma sem _explicit usa memory_order_seq_cst, mas pode não ser lock-free. Para inteiros atómicos, a aritmética com sinal usa complemento para dois sem resultado de overflow indefinido; para ponteiro atómico, o operando é ptrdiff_t e o resultado pode ser endereço inválido. O retorno é sempre o valor antigo. 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 tickets = 10;
    int previous = atomic_fetch_add(&tickets, 3);
    printf("%d %d\n", previous, atomic_load(&tickets));
    return 0;
}

Resultado

10 13

Serve para atribuir números sequenciais únicos ou incrementar contador partilhado sem atualizações perdidas. O exemplo soma realmente `3` a `10`: devolve o bilhete antigo `10` e o estado posterior é `13`.

Fontes