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

CKTIS / C

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

`atomic_compare_exchange_strong(object, expected, desired)` de `<stdatomic.h>` compara atomicamente o `*object` atómico com o `*expected` não atómico. Se iguais, guarda `desired` e devolve `true`; senão escreve o valor atual em `*expected` e devolve `false`, sem falha espúria.

Versão: C23

Sintaxe

bool atomic_compare_exchange_strong(volatile A *object, C *expected, C desired);

atomic_compare_exchange_strong(object, expected, desired) de <stdatomic.h> compara atomicamente o *object atómico com o *expected não atómico. Se iguais, guarda desired e devolve true; senão escreve o valor atual em *expected e devolve false, sem falha espúria.

Serve para uma tentativa única de transição de estado com caminhos separados para sucesso e divergência real. O exemplo substitui com sucesso 7→11 e depois volta a esperar 7; a segunda tentativa falha e atualiza expected para 11.

object tem de apontar para tipo atómico compatível e expected para o tipo não atómico correspondente modificável; ponteiros inválidos ou corrida em expected são erros. A forma sem _explicit usa memory_order_seq_cst. Comparar apenas o valor não resolve ABA nem protege outros dados sem protocolo de memória correto. Violar os requisitos dos ponteiros — incluindo ponteiro inválido, tipo apontado incompatível ou objeto expected não modificável — tem comportamento indefinido; uma corrida não sincronizada em expected também.

C23 compara o conteúdo, isto é, as representações dos valores designadas por object e expected, não apenas a sua igualdade matemática; a read-modify-write atómica incide sobre object, enquanto expected é armazenamento comum não atómico. O acesso concorrente não sincronizado a expected cria uma corrida de dados e comportamento indefinido. 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 <stdbool.h>
#include <stdio.h>

int main(void) {
    atomic_int value = 7;
    int expected = 7;
    bool replaced = atomic_compare_exchange_strong(&value, &expected, 11);

    expected = 7;
    bool rejected = atomic_compare_exchange_strong(&value, &expected, 13);
    printf("%d %d %d %d\n", replaced, rejected, atomic_load(&value), expected);
    return 0;
}

Resultado

1 0 11 11

Serve para uma tentativa única de transição de estado com caminhos separados para sucesso e divergência real. O exemplo substitui com sucesso `7→11` e depois volta a esperar `7`; a segunda tentativa falha e atualiza `expected` para `11`.

Fontes