KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C

atomic_fetch_sub — atomaire generieke C23-functie

`atomic_fetch_sub(object, operand)` uit `<stdatomic.h>` trekt `operand` atomair af van een atomair geheel of pointerobject en retourneert de waarde van vóór de aftrekking. Het is één read-modify-write-bewerking.

Versie: C23

Syntax

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

atomic_fetch_sub(object, operand) uit <stdatomic.h> trekt operand atomair af van een atomair geheel of pointerobject en retourneert de waarde van vóór de aftrekking. Het is één read-modify-write-bewerking.

Gebruik dit om een gedeelde teller zonder verloren updates te verlagen wanneer de oude waarde voor een beslissing nodig is. Het voorbeeld trekt werkelijk 6 af van 20: het retourneert de vorige 20 en de toestand erna is 14.

De vorm zonder _explicit gebruikt memory_order_seq_cst en hoeft niet lock-free te zijn. Hij verzadigt niet bij nul: signed atomaire gehele rekenkunde gebruikt tweecomplement zonder ongedefinieerde overloop, unsigned wikkelt modulo; bij een atomaire pointer is de operand ptrdiff_t en kan het resultaat een ongeldig adres zijn. De term „atomair geheel type” sluit _Atomic bool uitdrukkelijk uit; de afzonderlijk gespecificeerde vorm voor atomaire pointers blijft toegestaan.

De naam van deze generieke functie kan een macro of een externe identifier zijn; de macro onderdrukken om een echte functie aan te roepen, of een externe identifier met die naam definiëren, heeft ongedefinieerd gedrag.

Voorbeelden

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

Resultaat

20 14

Gebruik dit om een gedeelde teller zonder verloren updates te verlagen wanneer de oude waarde voor een beslissing nodig is. Het voorbeeld trekt werkelijk `6` af van `20`: het retourneert de vorige `20` en de toestand erna is `14`.

Bronnen