Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C

atomic_exchange — atomická generická funkce C23

`atomic_exchange(object, desired)` z `<stdatomic.h>` provede jedinou atomickou operaci read-modify-write: uloží `desired` do `*object` a vrátí hodnotu, kterou objekt měl bezprostředně před výměnou.

Verze: C23

Syntaxe

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

atomic_exchange(object, desired) z <stdatomic.h> provede jedinou atomickou operaci read-modify-write: uloží desired do *object a vrátí hodnotu, kterou objekt měl bezprostředně před výměnou.

Hodí se k převzetí atomického stavu či ukazatele, když je předchozí vlastník potřeba v témže linearizovatelném kroku. Příklad skutečně změní 5 na 9; vrátí 5 a následný atomic_load čte 9.

object musí ukazovat na kompatibilní správně inicializovaný atomický objekt; operace nemusí být lock-free. Forma bez _explicit používá memory_order_seq_cst. Vrací starou, ne novou hodnotu, a výměna jednoho objektu sama nesynchronizuje nezávislá data bez správného paměťového protokolu.

Název této generické funkce může být makro nebo externí identifikátor; potlačení makra za účelem volání skutečné funkce nebo definování externího identifikátoru tohoto názvu má nedefinované chování.

Pří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ýsledek

5 9

Hodí se k převzetí atomického stavu či ukazatele, když je předchozí vlastník potřeba v témže linearizovatelném kroku. Příklad skutečně změní `5` na `9`; vrátí `5` a následný `atomic_load` čte `9`.

Zdroje