Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C

atomic_fetch_xor — função genérica atómica C23

`atomic_fetch_xor(object, operand)` de `<stdatomic.h>` executa atomicamente `*object ^= operand` num tipo inteiro atómico e devolve o valor anterior à alternância dos bits. É uma única operação read-modify-write.

Versão: C23

Sintaxe

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

atomic_fetch_xor(object, operand) de <stdatomic.h> executa atomicamente *object ^= operand num tipo inteiro atómico e devolve o valor anterior à alternância dos bits. É uma única operação read-modify-write.

Serve para alternar atomicamente bits selecionados do estado partilhado. O exemplo aplica realmente XOR entre 0xA e 0x6: devolve o antigo 10 e o novo padrão 0xC vale 12.

Não suporta ponteiros atómicos; a forma sem _explicit usa memory_order_seq_cst e pode não ser lock-free. XOR alterna, não regista evento: duas chamadas com a mesma máscara restauram o estado anterior e dois avisos podem anular-se. A máscara deve ter largura e sinal pretendidos. 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 = 0xAu;
    unsigned previous = atomic_fetch_xor(&flags, 0x6u);
    printf("%u %u\n", previous, atomic_load(&flags));
    return 0;
}

Resultado

10 12

Serve para alternar atomicamente bits selecionados do estado partilhado. O exemplo aplica realmente XOR entre `0xA` e `0x6`: devolve o antigo `10` e o novo padrão `0xC` vale `12`.

Fontes