CKTIS / C
atomic_fetch_and — atomaire generieke C23-functie
`atomic_fetch_and(object, operand)` uit `<stdatomic.h>` voert atomair `*object &= operand` uit op een atomair geheel type en retourneert de waarde van vóór de bewerking. Het is één read-modify-write-bewerking.
Versie: C23
Syntax
C atomic_fetch_and(volatile A *object, M operand);atomic_fetch_and(object, operand) uit <stdatomic.h> voert atomair *object &= operand uit op een atomair geheel type en retourneert de waarde van vóór de bewerking. Het is één read-modify-write-bewerking.
Gebruik dit om geselecteerde bits gelijktijdig te wissen zonder vlaggen te overschrijven die andere threads intussen hebben gezet. Het voorbeeld begint met 0x7, wist bit 0x2 atomair via ~0x2u, retourneert de oude 7 en laat 5 achter.
De functie accepteert geen atomaire pointers; object moet naar een compatibel geïnitialiseerd atomair geheel type wijzen. De vorm zonder _explicit gebruikt memory_order_seq_cst en hoeft niet lock-free te zijn. Het masker moet de bedoelde breedte en signedness hebben; één maskerbewerking maakt geen invariant over andere atomaire objecten. De ondersteunde atomaire gehele typen sluiten _Atomic bool uitdrukkelijk uit; deze bewerking heeft geen pointervorm.
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_uint flags = 0x7u;
unsigned previous = atomic_fetch_and(&flags, ~0x2u);
printf("%u %u\n", previous, atomic_load(&flags));
return 0;
}
Resultaat
7 5
Gebruik dit om geselecteerde bits gelijktijdig te wissen zonder vlaggen te overschrijven die andere threads intussen hebben gezet. Het voorbeeld begint met `0x7`, wist bit `0x2` atomair via `~0x2u`, retourneert de oude `7` en laat `5` achter.