KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C

atomic_fetch_xor — atomaire generieke C23-functie

`atomic_fetch_xor(object, operand)` uit `<stdatomic.h>` voert atomair `*object ^= operand` uit op een atomair geheel type en retourneert de waarde van vóór het omschakelen van de bits. Het is één read-modify-write-bewerking.

Versie: C23

Syntax

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

atomic_fetch_xor(object, operand) uit <stdatomic.h> voert atomair *object ^= operand uit op een atomair geheel type en retourneert de waarde van vóór het omschakelen van de bits. Het is één read-modify-write-bewerking.

Gebruik dit om precies geselecteerde bits van gedeelde toestand atomair om te schakelen. Het voorbeeld XORt werkelijk 0xA met 0x6: het retourneert de oude 10 en het nieuwe patroon 0xC heeft waarde 12.

De functie ondersteunt geen atomaire pointers; de vorm zonder _explicit gebruikt memory_order_seq_cst en hoeft niet lock-free te zijn. XOR schakelt om en registreert geen gebeurtenis: twee aanroepen met hetzelfde masker herstellen de vorige toestand en twee meldingen kunnen elkaar opheffen. Het masker moet de bedoelde breedte en signedness hebben. 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 = 0xAu;
    unsigned previous = atomic_fetch_xor(&flags, 0x6u);
    printf("%u %u\n", previous, atomic_load(&flags));
    return 0;
}

Resultaat

10 12

Gebruik dit om precies geselecteerde bits van gedeelde toestand atomair om te schakelen. Het voorbeeld XORt werkelijk `0xA` met `0x6`: het retourneert de oude `10` en het nieuwe patroon `0xC` heeft waarde `12`.

Bronnen