KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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.

Bronnen