atomic_fetch_xor, atomic_fetch_xor_explicit

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

Ersetzt atomar den Wert, auf den obj zeigt, durch das Ergebnis der bitweisen XOR-Operation zwischen dem alten Wert von obj und arg , und gibt den zuvor in obj gespeicherten Wert zurück. Der Vorgang ist eine Read-Modify-Write-Operation. 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_xor ) ( ... ) ), oder ein Programm einen externen Bezeichner mit dem Namen einer generischen Funktion definiert, ist das Verhalten undefiniert.

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 bitweise XOR mit dem im atomaren Objekt gespeicherten Wert verknüpft 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_or atomic_fetch_or_explicit (C11)	atomares bitweises OR (Funktion)
atomic_fetch_and atomic_fetch_and_explicit (C11)	atomares bitweises AND (Funktion)
C++-Dokumentation für atomic_fetch_xor , atomic_fetch_xor_explicit