Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

atomic_fetch_or — funzione generica atomica C23

`atomic_fetch_or(object, operand)` di `<stdatomic.h>` esegue atomicamente `*object |= operand` su un tipo intero atomico e restituisce il valore precedente all’impostazione dei bit. È un’unica operazione read-modify-write.

Versione: C23

Sintassi

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

atomic_fetch_or(object, operand) di <stdatomic.h> esegue atomicamente *object |= operand su un tipo intero atomico e restituisce il valore precedente all’impostazione dei bit. È un’unica operazione read-modify-write.

Serve a segnalare flag indipendenti in concorrenza: un bit impostato da un thread non perde quelli impostati dagli altri. L’esempio combina davvero 0x1 con la maschera 0x6, restituisce il vecchio 1 e lascia i tre bit come 7.

Non supporta puntatori atomici; object deve essere un intero atomico compatibile e inizializzato. La forma senza _explicit usa memory_order_seq_cst e può non essere lock-free. OR può impostare bit ma non cancellarli, e osservare la vecchia maschera non conferma automaticamente l’elaborazione di un evento da parte di un altro thread. I tipi interi atomici supportati escludono esplicitamente _Atomic bool; questa operazione non ha una forma per puntatori.

Il nome di questa funzione generica può essere una macro o un identificatore esterno; sopprimere la macro per chiamare una funzione reale o definire un identificatore esterno con quel nome ha comportamento indefinito.

Esempi

#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;
}

Risultato

1 7

Serve a segnalare flag indipendenti in concorrenza: un bit impostato da un thread non perde quelli impostati dagli altri. L’esempio combina davvero `0x1` con la maschera `0x6`, restituisce il vecchio `1` e lascia i tre bit come `7`.

Fonti