CKTIS / C
atomic_fetch_add — atomaire generieke C23-functie
`atomic_fetch_add(object, operand)` uit `<stdatomic.h>` telt `operand` atomair op bij een atomair geheel getal of pointerobject en retourneert de waarde van vóór de optelling. Het is één read-modify-write-bewerking.
Versie: C23
Syntax
C atomic_fetch_add(volatile A *object, M operand);atomic_fetch_add(object, operand) uit <stdatomic.h> telt operand atomair op bij een atomair geheel getal of pointerobject en retourneert de waarde van vóór de optelling. Het is één read-modify-write-bewerking.
Gebruik dit om unieke volgnummers uit te delen of een gedeelde teller zonder verloren updates te verhogen. Het voorbeeld telt werkelijk 3 op bij 10: de geretourneerde oude ticketwaarde is 10 en de toestand erna is 13.
De vorm zonder _explicit gebruikt memory_order_seq_cst, maar hoeft niet lock-free te zijn. Voor atomaire gehele typen gebruikt signed rekenwerk tweecomplement zonder ongedefinieerd overloopresultaat; bij een atomaire pointer is de operand ptrdiff_t en kan het resultaat een ongeldig adres zijn. De retour is altijd de oude waarde. 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 tickets = 10;
int previous = atomic_fetch_add(&tickets, 3);
printf("%d %d\n", previous, atomic_load(&tickets));
return 0;
}
Resultaat
10 13
Gebruik dit om unieke volgnummers uit te delen of een gedeelde teller zonder verloren updates te verhogen. Het voorbeeld telt werkelijk `3` op bij `10`: de geretourneerde oude ticketwaarde is `10` en de toestand erna is `13`.