atomic_fetch_and, atomic_fetch_and_explicit

Definiert in Header <stdatomic.h>
C atomic_fetch_and ( volatile A * obj, M arg ) ;	(1)	(seit C11)
C atomic_fetch_and_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 UND-Verknüpfung zwischen dem alten Wert von obj und arg , und gibt den Wert zurück, der zuvor in obj gespeichert war. Der Vorgang ist eine Lese-Modifizier-Schreib-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_and ) ( ... ) ), 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 UND mit dem im atomaren Objekt gespeicherten Wert verknüpft wird
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)	Atomisches bitweises OR (Funktion)
atomic_fetch_xor atomic_fetch_xor_explicit (C11)	Atomisches bitweises exklusives OR (Funktion)
C++-Dokumentation für atomic_fetch_and , atomic_fetch_and_explicit