Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

<stdatomic.h> — operazioni atomiche

L’header per le operazioni atomiche sui dati condivisi tra thread; fornisce flag e macro che descrivono la proprietà lock-free.

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

Sintassi

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

<stdatomic.h> fornisce tipi e operazioni atomiche. Un’implementazione che definisce __STDC_NO_ATOMICS__ non è tenuta a fornirlo.

Le macro corrispondono ai tipi atomici: 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 → puntatori. Per i tipi interi applicabili, comprendono le varianti signed e unsigned.

Valori delle macro, utilizzabili in #if: 0 — mai lock-free, 1 — a volte, 2 — sempre. Atomico non significa lock-free; anche atomic_is_lock_free consente di verificare questa proprietà.

ATOMIC_FLAG_INIT inizializza atomic_flag nello stato azzerato. Le operazioni sui flag sono lock-free. L’esempio mostra gli stati precedenti restituiti da atomic_flag_test_and_set e il ripristino con atomic_flag_clear.

Esempi

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

Risultato

0 1 0

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti