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
Nur bereitgestellt, wenn T ein arithmetischer Typ außer cv bool oder ein Zeiger-auf-Objekt-Typ ist
value_type fetch_sub ( difference_type arg,

std:: memory_order order =

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

Ersetzt atomar den aktuellen Wert des referenzierten Objekts mit dem Ergebnis der arithmetischen Subtraktion des Werts und arg . Dieser Vorgang ist ein Lese-Modifizieren-Schreiben-Vorgang. Der Speicher wird gemäß dem Wert von order beeinflusst.

  • Für vorzeichenbehaftete Ganzzahltypen ist die Arithmetik als Zweierkomplementdarstellung definiert. Es gibt keine undefinierten Ergebnisse.
  • Für Gleitkommatypen kann die Gleitkommaumgebung von der Gleitkommaumgebung des aufrufenden Threads abweichen. Die Operation muss nicht den entsprechenden std::numeric_limits Eigenschaften entsprechen, wird jedoch dazu ermutigt. Wenn das Ergebnis kein darstellbarer Wert für seinen Typ ist, ist das Ergebnis nicht spezifiziert, aber die Operation hat ansonsten kein undefiniertes Verhalten.
  • Für Zeigertypen kann das Ergebnis eine undefinierte Adresse sein, aber die Operation hat ansonsten kein undefiniertes Verhalten.

Diese Überladung nimmt nur dann an der Überladungsauflösung teil, wenn std:: is_const_v < T > false ist.

Inhaltsverzeichnis

Parameter

arg - das andere Argument der arithmetischen Subtraktion
order - Speicherreihenfolgenbeschränkungen zur Durchsetzung

Rückgabewert

Der von * ptr referenzierte Wert, unmittelbar vor den Effekten dieser Funktion.

Beispiel

Dieser Abschnitt ist unvollständig
Grund: Kein Beispiel

Fehlerberichte

Die folgenden verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

DR Angewendet auf Verhalten wie veröffentlicht Korrigiertes Verhalten
LWG 3508
( P3323R1 ) 		C++20 fetch_sub war bedeutungslos für const T eingeschränkt, um nur non-const T zu akzeptieren