atomic_fetch_sub, atomic_fetch_sub_explicit

Definiert im Header <stdatomic.h>
C atomic_fetch_sub ( volatile A * obj, M arg ) ;	(1)	(seit C11)
C atomic_fetch_sub_explicit ( volatile A * obj, M arg, memory_order order ) ;	(2)	(seit C11)

Ersetzt atomar den Wert, auf den obj zeigt, durch das Ergebnis der Subtraktion von arg vom alten Wert von obj , und gibt den Wert zurück, der zuvor in obj gespeichert war. Der Vorgang ist ein Lese-Modifizier-Schreib-Vorgang. Die erste Version ordnet Speicherzugriffe gemäß memory_order_seq_cst , die zweite Version ordnet Speicherzugriffe gemäß order .

Dies ist eine generische Funktion , die für alle atomaren Objekttypen A definiert ist. Das Argument ist ein Zeiger auf einen flüchtigen atomaren Typ, um Adressen sowohl von nicht-flüchtigen als auch flüchtigen (z.B. speichergemappten E/A) atomaren Objekten zu akzeptieren, und die flüchtige Semantik wird beibehalten, wenn diese Operation auf flüchtige atomare Objekte angewendet wird. M ist entweder der nicht-atomare Typ, der A entspricht, wenn A ein atomarer Ganzzahltyp ist, oder ptrdiff_t , wenn A ein atomarer Zeigertyp ist.

Es ist nicht spezifiziert, ob der Name einer generischen Funktion ein Makro oder ein mit externer Bindung deklarierter Bezeichner ist. Wenn eine Makrodefinition unterdrückt wird, um auf eine tatsächliche Funktion zuzugreifen (z. B. in Klammern gesetzt wie ( atomic_fetch_sub ) ( ... ) ), oder ein Programm einen externen Bezeichner mit dem Namen einer generischen Funktion definiert, ist das Verhalten undefiniert.

Für vorzeichenbehaftete Ganzzahltypen ist die Arithmetik als Zweierkomplement-Darstellung definiert. Es gibt keine undefinierten Ergebnisse. Für Zeigertypen kann das Ergebnis eine undefinierte Adresse sein, aber die Operationen haben ansonsten kein undefiniertes Verhalten.

Inhaltsverzeichnis 1 Parameter 2 Rückgabewert 3 Referenzen 4 Siehe auch

Parameter

obj	-	Zeiger auf das atomare Objekt, das modifiziert werden soll
arg	-	der Wert, der vom im atomaren Objekt gespeicherten Wert subtrahiert werden soll
order	-	die Speichersynchronisierungsreihenfolge für diesen Vorgang: alle Werte sind erlaubt

Rückgabewert

Der zuvor vom atomaren Objekt, auf das obj zeigt, gehaltene Wert.

Referenzen

Siehe auch

atomic_fetch_add atomic_fetch_add_explicit (C11)	Atomare Addition (Funktion)
C++-Dokumentation für atomic_fetch_sub , atomic_fetch_sub_explicit