System.SyncObjs.TInterlocked.CompareExchange

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

class function CompareExchange(var Target: Pointer; Value: Pointer; Comparand: Pointer): Pointer; overload; static; inline;
class function CompareExchange(var Target: Integer; Value: Integer; Comparand: Integer): Integer; overload; static; inline;
class function CompareExchange(var Target: Integer; Value: Integer; Comparand: Integer; out Succeeded: Boolean): Integer; overload; static;
class function CompareExchange(var Target: Int64; Value: Int64; Comparand: Int64): Int64; overload; static; inline;
class function CompareExchange(var Target: TObject; Value: TObject; Comparand: TObject): TObject; overload; static; inline;
class function CompareExchange(var Target: Double; Value: Double; Comparand: Double): Double; overload; static; inline;
class function CompareExchange(var Target: Single; Value: Single; Comparand: Single): Single; overload; static; inline;
class function CompareExchange<T: class>(var Target: T; Value: T; Comparand: T): T; overload; static; inline;

C++

static void * __fastcall CompareExchange(void * &Target, void * Value, void * Comparand)/* overload */;
static int __fastcall CompareExchange(int &Target, int Value, int Comparand)/* overload */;
static int __fastcall CompareExchange(int &Target, int Value, int Comparand, /* out */ bool &Succeeded)/* overload */;
static __int64 __fastcall CompareExchange(__int64 &Target, __int64 Value, __int64 Comparand)/* overload */;
static System::TObject* __fastcall CompareExchange(System::TObject* &Target, System::TObject* Value, System::TObject* Comparand)/* overload */;
static double __fastcall CompareExchange(double &Target, double Value, double Comparand)/* overload */;
static float __fastcall CompareExchange(float &Target, float Value, float Comparand)/* overload */;
template<typename T> static T __fastcall CompareExchange(T &Target, T Value, T Comparand)/* overload */;

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function public
System.SyncObjs.pas
System.SyncObjs.hpp
System.SyncObjs TInterlocked

Beschreibung

Vergleicht die Inhalte von Target und Comparand und, wenn sie gleich sind, ändert es den Inhalt von Target.

CompareExchange vergleicht den Wert von Target mit dem Wert von Comparand. Wenn der Wert von Target mit dem Wert von Comparand gleich ist, dann wird der Wert von Value an der von Targetangegebenen Adresse gespeichert. Ansonsten wird keine Aktion durchgeführt.

Es gibt acht CompareExchange-Überladungen. Eine von ihnen nimmt den zusätzlichen Parameter Succeeded an. Dieser Parameter erhält bei einer erfolgreichen Operation den Wert True, ansonsten False. Die letzte Methode hat sowohl generische Parameter als auch einen generischen Rückgabetyp; außerdem kann sie Parameter aller Typen entgegennehmen.

Siehe auch