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`.