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

CKTIS / C

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

`atomic_exchange(object, desired)` de `<stdatomic.h>` executa uma única operação atómica read-modify-write: guarda `desired` em `*object` e devolve o valor existente imediatamente antes da troca.

Versão: C23

Sintaxe

C atomic_exchange(volatile A *object, C desired);

atomic_exchange(object, desired) de <stdatomic.h> executa uma única operação atómica read-modify-write: guarda desired em *object e devolve o valor existente imediatamente antes da troca.

Serve para tomar posse de um estado ou ponteiro atómico quando o proprietário anterior é necessário no mesmo passo linearizável. O exemplo muda realmente 5 para 9; devolve 5 e o atomic_load posterior lê 9.

object tem de apontar para objeto atómico compatível e corretamente inicializado; a operação pode não ser lock-free. A forma sem _explicit usa memory_order_seq_cst. O retorno é o valor antigo, não o novo, e trocar um objeto não sincroniza dados independentes sem protocolo de memória correto.

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 value = 5;
    int previous = atomic_exchange(&value, 9);
    printf("%d %d\n", previous, atomic_load(&value));
    return 0;
}

Resultado

5 9

Serve para tomar posse de um estado ou ponteiro atómico quando o proprietário anterior é necessário no mesmo passo linearizável. O exemplo muda realmente `5` para `9`; devolve `5` e o `atomic_load` posterior lê `9`.

Fontes