Namespaces
Variants

atomic_fetch_or, atomic_fetch_or_explicit

From cppreference.net
Definiert im Header <stdatomic.h>
C atomic_fetch_or ( volatile A * obj, M arg ) ;
(1) (seit C11)
C atomic_fetch_or_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 ODER-Operation zwischen dem alten Wert von obj und arg , und gibt den zuvor in obj gehaltenen 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_or ) ( ... ) ), oder ein Programm einen externen Bezeichner mit dem Namen einer generischen Funktion definiert, ist das Verhalten undefiniert.

Inhaltsverzeichnis

Parameter

obj - Zeiger auf das atomare Objekt, das modifiziert werden soll
arg - der Wert, der bitweise ODER 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

  • C17-Standard (ISO/IEC 9899:2018):
  • 7.17.7.5 Die atomic_fetch- und Modify-Generic-Funktionen (S: 208)
  • C11-Standard (ISO/IEC 9899:2011):
  • 7.17.7.5 Die atomic_fetch- und modify-Generic-Funktionen (S: 284-285)

Siehe auch

atomares bitweises UND
(Funktion)
atomares bitweises exklusives ODER
(Funktion)
C++-Dokumentation für atomic_fetch_or , atomic_fetch_or_explicit