CKTIS / C
atomic_fetch_or — função genérica atómica C23
`atomic_fetch_or(object, operand)` de `<stdatomic.h>` executa atomicamente `*object |= operand` num tipo inteiro atómico e devolve o valor anterior à definição dos bits. É uma única operação read-modify-write.
Versão: C23
Sintaxe
C atomic_fetch_or(volatile A *object, M operand);atomic_fetch_or(object, operand) de <stdatomic.h> executa atomicamente *object |= operand num tipo inteiro atómico e devolve o valor anterior à definição dos bits. É uma única operação read-modify-write.
Serve para comunicar flags independentes concorrentemente: um bit definido por uma thread não perde bits definidos por outras. O exemplo combina realmente 0x1 com a máscara 0x6, devolve o antigo 1 e deixa os três bits como 7.
Não suporta ponteiros atómicos; object tem de ser inteiro atómico compatível e inicializado. A forma sem _explicit usa memory_order_seq_cst e pode não ser lock-free. OR pode definir bits mas não limpá-los, e observar a máscara antiga não confirma automaticamente que outra thread processou um evento. Os tipos inteiros atómicos suportados excluem explicitamente _Atomic bool; esta operação não tem forma para ponteiros.
O nome desta função genérica pode ser uma macro ou um identificador externo; suprimir a macro para chamar uma função real ou definir um identificador externo com esse nome tem comportamento indefinido.
Exemplos
#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;
}
Resultado
1 7
Serve para comunicar flags independentes concorrentemente: um bit definido por uma thread não perde bits definidos por outras. O exemplo combina realmente `0x1` com a máscara `0x6`, devolve o antigo `1` e deixa os três bits como `7`.