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

CKTIS / C

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

`atomic_fetch_sub(object, operand)` от `<stdatomic.h>` атомарно изважда `operand` от атомарен целочислен обект или указател и връща стойността преди изваждането. Това е една операция read-modify-write.

Версия: C23

Синтаксис

C atomic_fetch_sub(volatile A *object, M operand);

atomic_fetch_sub(object, operand) от <stdatomic.h> атомарно изважда operand от атомарен целочислен обект или указател и връща стойността преди изваждането. Това е една операция read-modify-write.

Подходяща е за намаляване на споделен брояч без загубени обновявания, когато старата стойност е нужна за решение. Примерът действително изважда 6 от 20: връща предишното 20, а състоянието след операцията е 14.

Формата без _explicit използва memory_order_seq_cst и не е задължително lock-free. Не се насища при нула: знаковата атомарна целочислена аритметика използва допълнение до две без неопределено препълване, беззнаковата се завърта модулно; за атомарен указател операндът е ptrdiff_t, а резултатът може да е невалиден адрес. Изразът „атомен целочислен тип“ изрично изключва _Atomic bool; отделно специфицираната форма за атомарен указател остава разрешена.

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

Примери

#include <stdatomic.h>
#include <stdio.h>

int main(void) {
    atomic_int remaining = 20;
    int previous = atomic_fetch_sub(&remaining, 6);
    printf("%d %d\n", previous, atomic_load(&remaining));
    return 0;
}

Резултат

20 14

Подходяща е за намаляване на споделен брояч без загубени обновявания, когато старата стойност е нужна за решение. Примерът действително изважда `6` от `20`: връща предишното `20`, а състоянието след операцията е `14`.

Източници