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