Namespaces
Variants

std::atomic_ref<T>:: fetch_sub

From cppreference.net
C++
Concurrency support library
Threads
(C++11)
(C++20)
(C++17) (C++17)
this_thread namespace
(C++11)
(C++11)
Cooperative cancellation
Mutual exclusion
Generic lock management
Condition variables
(C++11)
(C++11)
(C++11)
(C++11)
Semaphores
(C++20) (C++20)
Latches and Barriers
(C++20)
(C++20)
Futures
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
Safe reclamation
Hazard pointers
(C++26)
(C++26)
(C++26)
Atomic types
(C++11)
(C++20)
(C++11)
Initialization of atomic types
(C++11) (deprecated in C++20)
(C++11) (deprecated in C++20)
(C++11)
Memory ordering
(C++11)
(C++11) (deprecated in C++26)
(C++11)
(C++11)
Free functions for atomic operations
(C++11) (C++11)
(C++11) (C++11)
(C++11) (C++11)
(C++11) (C++11) (C++11) (C++11)
(C++11) (C++11)
(C++11) (C++11)
(C++11) (C++11)
(C++11) (C++11)
(C++11) (C++11)
(C++26) (C++26)
(C++26) (C++26)
(C++11)
(C++20) (C++20)
(C++20)
(C++20)
Free functions for atomic flags
(C++11) (C++11)
(C++11) (C++11)
(C++20) (C++20)
(C++20) (C++20)
(C++20)
(C++20)
std::atomic_ref
Member functions
(C++26)
Operations for arithmetic types
(except bool and pointer-to-object)
atomic_ref::fetch_sub
Operations for integral types
(except bool and pointer-to-object)
(C++26)
(C++26)
Operations for integral types
(except bool )
Constants
Fourni uniquement lorsque T est un type arithmétique autre que cv bool ou un type pointeur-vers-objet
value_type fetch_sub ( difference_type arg,

std:: memory_order order =

std:: memory_order_seq_cst ) const noexcept ;
(constexpr depuis C++26)

Remplace atomiquement la valeur actuelle de l'objet référencé par le résultat de la soustraction arithmétique de la valeur et arg . Cette opération est une opération de lecture-modification-écriture. La mémoire est affectée selon la valeur de order .

  • Pour les types entiers signés, l'arithmétique est définie pour utiliser la représentation en complément à deux. Il n'y a aucun résultat indéfini.
  • Pour les types à virgule flottante, l' environnement de virgule flottante en vigueur peut être différent de l'environnement de virgule flottante du thread appelant. L'opération n'a pas besoin de se conformer aux traits correspondants de std::numeric_limits mais est encouragée à le faire. Si le résultat n'est pas une valeur représentable pour son type, le résultat est non spécifié mais l'opération n'a par ailleurs aucun comportement indéfini.
  • Pour les types pointeurs, le résultat peut être une adresse indéfinie, mais l'opération n'a par ailleurs aucun comportement indéfini.

Cette surcharge participe à la résolution de surcharge seulement si std:: is_const_v < T > est false .

Table des matières

Paramètres

arg - l'autre argument de la soustraction arithmétique
order - contraintes d'ordre mémoire à appliquer

Valeur de retour

La valeur référencée par * ptr , immédiatement avant les effets de cette fonction.

Exemple

Cette section est incomplète
Raison : aucun exemple

Rapports de défauts

Les rapports de défauts modifiant le comportement suivants ont été appliqués rétroactivement aux normes C++ précédemment publiées.

DR Appliqué à Comportement publié Comportement corrigé
LWG 3508
( P3323R1 ) 		C++20 fetch_sub n'avait aucun sens pour const T contraint pour n'accepter que les T non constants