CKTIS / C
atomic_exchange — atómová generická funkcia C23
`atomic_exchange(object, desired)` z `<stdatomic.h>` vykoná jedinú atómovú operáciu read-modify-write: uloží `desired` do `*object` a vráti hodnotu, ktorú objekt mal bezprostredne pred výmenou.
Verzia: C23
Syntax
C atomic_exchange(volatile A *object, C desired);atomic_exchange(object, desired) z <stdatomic.h> vykoná jedinú atómovú operáciu read-modify-write: uloží desired do *object a vráti hodnotu, ktorú objekt mal bezprostredne pred výmenou.
Hodí sa na prevzatie atómového stavu či ukazovateľa, keď je predchádzajúci vlastník potrebný v tom istom linearizovateľnom kroku. Príklad skutočne zmení 5 na 9; vráti 5 a následný atomic_load číta 9.
object musí ukazovať na kompatibilný správne inicializovaný atómový objekt; operácia nemusí byť lock-free. Forma bez _explicit používa memory_order_seq_cst. Vracia starú, nie novú hodnotu, a výmena jedného objektu sama nesynchronizuje nezávislé dáta bez správneho pamäťového protokolu.
Názov tejto generickej funkcie môže byť makro alebo externý identifikátor; potlačenie makra na volanie skutočnej funkcie alebo definovanie externého identifikátora s týmto názvom má nedefinované správanie.
Príklady
#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;
}
Výsledok
5 9
Hodí sa na prevzatie atómového stavu či ukazovateľa, keď je predchádzajúci vlastník potrebný v tom istom linearizovateľnom kroku. Príklad skutočne zmení `5` na `9`; vráti `5` a následný `atomic_load` číta `9`.