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

CKTIS / C++

std::atomic_ref : opérations atomiques sur un objet existant

std::atomic_ref crée une vue atomique non propriétaire sur un objet existant trivialement copiable.

Version : C++23

Syntaxe

template<class T>
struct atomic_ref;

static constexpr std::size_t required_alignment = implementation-defined;
explicit atomic_ref(T& object);
T load(std::memory_order order = std::memory_order_seq_cst) const noexcept;
void store(T desired, std::memory_order order = std::memory_order_seq_cst) const noexcept;
// applicable numeric and pointer specializations additionally provide:
T fetch_add(/* difference type */ operand,
    std::memory_order order = std::memory_order_seq_cst) const noexcept;

std::atomic_ref<T> de <atomic> ne possède aucune valeur : il se lie à un T existant et y exécute load, store, exchange, compare-exchange et les opérations read-modify-write adaptées. L’objet référencé doit vivre plus longtemps que toutes ses vues.

T doit être trivialement copiable et l’adresse respecter atomic_ref<T>::required_alignment. Tant qu’une vue existe, tout accès à l’objet complet doit passer exclusivement par des instances atomic_ref compatibles ; une lecture ou écriture ordinaire concurrente viole le contrat. std::atomic_ref::required_alignment donne l’alignement requis de l’objet que la vue référencera. Sur une spécialisation numérique ou pointeur appropriée, std::atomic_ref::fetch_add ajoute atomiquement son opérande en une opération read-modify-write et renvoie la valeur précédente.

La vue est copiable, mais une affectation ne peut pas la relier ailleurs. Les opérations ne sont pas forcément lock-free ; consulte is_lock_free(). L’ordre par défaut est std::memory_order_seq_cst ; des ordres plus faibles exigent un protocole correct.

Exemples

#include <atomic>
#include <iostream>

int main() {
    alignas(std::atomic_ref<int>::required_alignment) int value = 3;
    std::atomic_ref<int> view{value};
    view.fetch_add(4);
    std::cout << view.load() << '\n';
}

Résultat

7

std::atomic_ref → 7

Sources