База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C

atomic_exchange — атомарна обобщена функция на C23

`atomic_exchange(object, desired)` от `<stdatomic.h>` извършва една атомарна операция read-modify-write: записва `desired` в `*object` и връща стойността непосредствено преди размяната.

Версия: C23

Синтаксис

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

atomic_exchange(object, desired) от <stdatomic.h> извършва една атомарна операция read-modify-write: записва desired в *object и връща стойността непосредствено преди размяната.

Подходяща е за поемане на атомарно състояние или указател, когато предишният собственик е нужен в същата линеаризируема стъпка. Примерът действително сменя 5 с 9; връща 5, а последващият atomic_load прочита 9.

object трябва да сочи съвместим, правилно инициализиран атомарен обект; операцията не е задължително lock-free. Формата без _explicit използва memory_order_seq_cst. Връща старата, не новата стойност, а размяната на един обект не синхронизира независими данни без правилен протокол за паметта.

Името на тази обобщена функция може да е макрос или външен идентификатор; потискането на макроса за извикване на действителна функция или дефинирането на външен идентификатор с това име има неопределено поведение.

Примери

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

Резултат

5 9

Подходяща е за поемане на атомарно състояние или указател, когато предишният собственик е нужен в същата линеаризируема стъпка. Примерът действително сменя `5` с `9`; връща `5`, а последващият `atomic_load` прочита `9`.

Източници