Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C

<stdatomic.h> — opérations atomiques

L’en-tête consacré aux opérations atomiques sur les données partagées entre threads ; il fournit des indicateurs et des macros qui décrivent la propriété lock-free.

Version : C23; repository compiler flag, production runtime not attested

Syntaxe

#include <stdatomic.h>
atomic_flag flag = ATOMIC_FLAG_INIT;

<stdatomic.h> fournit des types et des opérations atomiques. Une implémentation qui définit __STDC_NO_ATOMICS__ n’est pas tenue de le fournir.

Les macros correspondent aux types atomiques : ATOMIC_BOOL_LOCK_FREE → bool ; ATOMIC_CHAR_LOCK_FREE → char ; ATOMIC_CHAR16_T_LOCK_FREE → char16_t ; ATOMIC_CHAR32_T_LOCK_FREE → char32_t ; ATOMIC_WCHAR_T_LOCK_FREE → wchar_t ; ATOMIC_SHORT_LOCK_FREE → short ; ATOMIC_INT_LOCK_FREE → int ; ATOMIC_LONG_LOCK_FREE → long ; ATOMIC_LLONG_LOCK_FREE → long long ; ATOMIC_POINTER_LOCK_FREE → les pointeurs. Pour les types entiers concernés, elles couvrent les variantes signées et non signées.

Valeurs des macros, utilisables dans #if : 0 — jamais lock-free, 1 — parfois, 2 — toujours. Atomique ne signifie pas lock-free ; atomic_is_lock_free permet également d’interroger cette propriété.

ATOMIC_FLAG_INIT initialise atomic_flag à l’état effacé. Les opérations sur les indicateurs sont lock-free. L’exemple montre les états précédents renvoyés par atomic_flag_test_and_set et la réinitialisation avec atomic_flag_clear.

Exemples

#include <stdatomic.h>
#include <stdio.h>

int main(void)
{
    atomic_flag flag = ATOMIC_FLAG_INIT;
    int first = atomic_flag_test_and_set(&flag);
    int second = atomic_flag_test_and_set(&flag);
    atomic_flag_clear(&flag);
    int third = atomic_flag_test_and_set(&flag);

    printf("%d %d %d\n", first, second, third);
    return 0;
}

Résultat

0 1 0

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources