Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

atomic_compare_exchange_strong — atomowa funkcja generyczna C23

`atomic_compare_exchange_strong(object, expected, desired)` z `<stdatomic.h>` atomowo porównuje wartość atomową `*object` z nieatomową wartością `*expected`. Przy równości zapisuje `desired` do obiektu i zwraca `true`; przy nierówności zapisuje bieżącą wartość obiektu do `*expected` i zwraca `false`, bez fałszywej porażki.

Wersja: C23

Składnia

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

atomic_compare_exchange_strong(object, expected, desired) z <stdatomic.h> atomowo porównuje wartość atomową *object z nieatomową wartością *expected. Przy równości zapisuje desired do obiektu i zwraca true; przy nierówności zapisuje bieżącą wartość obiektu do *expected i zwraca false, bez fałszywej porażki.

Nadaje się do jednorazowej próby przejścia stanu, gdy kod ma osobno obsłużyć sukces i rzeczywistą niezgodność. Przykład wykonuje udaną zamianę 7→11, a następnie nieudaną próbę z oczekiwanym 7; druga próba aktualizuje expected do 11.

object musi wskazywać zgodny typ atomowy, a expected — modyfikowalny odpowiadający typ nieatomowy; nieważne wskaźniki lub wyścig na expected są błędne. Wariant bez _explicit używa memory_order_seq_cst. Porównanie samej wartości nie rozwiązuje problemu ABA i nie chroni innych współdzielonych danych bez właściwego protokołu porządku pamięci. Naruszenie wymagań wskaźników — w tym nieważny wskaźnik, niezgodny wskazywany typ albo niemodyfikowalny obiekt expected — ma niezdefiniowane zachowanie; niesynchronizowany wyścig na expected również ma niezdefiniowane zachowanie.

C23 porównuje zawartość, czyli reprezentacje wartości wskazywane przez object i expected, a nie tylko ich matematyczną równość; atomowa operacja read-modify-write dotyczy object, natomiast expected jest zwykłą pamięcią nieatomową. Równoczesny niesynchronizowany dostęp do expected tworzy wyścig danych i niezdefiniowane zachowanie. Nazwa tej funkcji generycznej może być makrem albo identyfikatorem zewnętrznym; stłumienie makra w celu wywołania rzeczywistej funkcji lub zdefiniowanie zewnętrznego identyfikatora o tej nazwie ma niezdefiniowane zachowanie.

Przykłady

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

Wynik

1 0 11 11

Nadaje się do jednorazowej próby przejścia stanu, gdy kod ma osobno obsłużyć sukces i rzeczywistą niezgodność. Przykład wykonuje udaną zamianę `7→11`, a następnie nieudaną próbę z oczekiwanym `7`; druga próba aktualizuje `expected` do `11`.

Źródła