Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C

atomic_exchange — atomska generična funkcija C23

`atomic_exchange(object, desired)` iz `<stdatomic.h>` izvede eno atomsko operacijo read-modify-write: shrani `desired` v `*object` in vrne vrednost, ki jo je objekt imel neposredno pred zamenjavo.

Različica: C23

Sintaksa

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

atomic_exchange(object, desired) iz <stdatomic.h> izvede eno atomsko operacijo read-modify-write: shrani desired v *object in vrne vrednost, ki jo je objekt imel neposredno pred zamenjavo.

Primerna je za prevzem atomskega stanja ali kazalca, kadar je prejšnji lastnik potreben v istem linearizabilnem koraku. Primer res spremeni 5 v 9; vrne 5, poznejši atomic_load pa prebere 9.

object mora kazati na združljiv pravilno inicializiran atomski objekt; operacija ni nujno lock-free. Oblika brez _explicit uporablja memory_order_seq_cst. Vrne staro, ne nove vrednosti, zamenjava enega objekta pa brez pravilnega pomnilniškega protokola ne sinhronizira neodvisnih podatkov.

Ime te generične funkcije je lahko makro ali zunanji identifikator; zatiranje makra za klic dejanske funkcije ali definiranje zunanjega identifikatorja s tem imenom ima nedoločeno vedenje.

Primeri

#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;
}

Rezultat

5 9

Primerna je za prevzem atomskega stanja ali kazalca, kadar je prejšnji lastnik potreben v istem linearizabilnem koraku. Primer res spremeni `5` v `9`; vrne `5`, poznejši `atomic_load` pa prebere `9`.

Viri