Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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

Zdroje