KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C

atomic_fetch_or — atomaire generieke C23-functie

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

Versie: C23

Syntax

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

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

Gebruik dit om onafhankelijke vlaggen gelijktijdig te melden: een bit dat één thread zet, verliest geen bits van andere threads. Het voorbeeld combineert werkelijk 0x1 met masker 0x6, retourneert de oude 1 en laat alle drie bits als 7 achter.

De functie ondersteunt geen atomaire pointers; object moet een compatibel geïnitialiseerd atomair geheel type zijn. De vorm zonder _explicit gebruikt memory_order_seq_cst en hoeft niet lock-free te zijn. OR kan bits zetten maar niet wissen, en de oude waarde zien bevestigt niet automatisch dat een andere thread een gebeurtenis verwerkte. 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 = 0x1u;
    unsigned previous = atomic_fetch_or(&flags, 0x6u);
    printf("%u %u\n", previous, atomic_load(&flags));
    return 0;
}

Resultaat

1 7

Gebruik dit om onafhankelijke vlaggen gelijktijdig te melden: een bit dat één thread zet, verliest geen bits van andere threads. Het voorbeeld combineert werkelijk `0x1` met masker `0x6`, retourneert de oude `1` en laat alle drie bits als `7` achter.

Bronnen