CKTIS / C
atomic_fetch_and — função genérica atómica C23
`atomic_fetch_and(object, operand)` de `<stdatomic.h>` executa atomicamente `*object &= operand` num tipo inteiro atómico e devolve o valor anterior. É uma única operação read-modify-write.
Versão: C23
Sintaxe
C atomic_fetch_and(volatile A *object, M operand);atomic_fetch_and(object, operand) de <stdatomic.h> executa atomicamente *object &= operand num tipo inteiro atómico e devolve o valor anterior. É uma única operação read-modify-write.
Serve para limpar bits selecionados concorrentemente sem sobrescrever flags entretanto definidos por outras threads. O exemplo começa em 0x7, limpa atomicamente o bit 0x2 através de ~0x2u, devolve o antigo 7 e deixa 5.
Não aceita ponteiros atómicos; object tem de apontar para inteiro atómico compatível e inicializado. A forma sem _explicit usa memory_order_seq_cst e pode não ser lock-free. A máscara deve ter largura e sinal pretendidos; uma operação de máscara não cria invariante abrangendo outros objetos atómicos. 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 = 0x7u;
unsigned previous = atomic_fetch_and(&flags, ~0x2u);
printf("%u %u\n", previous, atomic_load(&flags));
return 0;
}
Resultado
7 5
Serve para limpar bits selecionados concorrentemente sem sobrescrever flags entretanto definidos por outras threads. O exemplo começa em `0x7`, limpa atomicamente o bit `0x2` através de `~0x2u`, devolve o antigo `7` e deixa `5`.