System.VarCmplx.VarComplexCreate

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function VarComplexCreate: Variant;
function VarComplexCreate(const AReal: Double): Variant;
function VarComplexCreate(const AReal, AImaginary: Double): Variant;
function VarComplexCreate(const AText: string): Variant;

C++

extern DELPHI_PACKAGE System::Variant __fastcall VarComplexCreate(void)/* overload */;

Eigenschaften

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

Beschreibung

Gibt eine benutzerdefinierte Variante zurück, die eine komplexe Zahl repräsentiert.

Mit VarComplexCreate erstellen Sie eine Variante, deren Wert eine komplexe Zahl ist.

AReal ist der Realteil der komplexen Zahl.

AImaginary ist der Imaginärteil der komplexen Zahl.

Die ersten drei Versionen des Konstruktors liefern bei Weglassen von AReal oder AImaginary einen Realteil bzw. Imaginärteil von 0.

In der letzten Syntax wird AText auf Basis der globalen Variablen ComplexNumberSymbol und ComplexNumberSymbolBeforeImaginary zerlegt. Wenn der entstehende String eine komplexe Zahl darstellt, wird diese zum Wert der Variante. Kann der String nicht in eine komplexe Zahl zerlegt werden, löst VarComplexCreate eine EConvertError-Exception aus.

Komplexe Varianten sind benutzerdefinierte Varianten zur Darstellung komplexer Zahlen. Der Variantentyp unterstützt die direkte Verarbeitung durch Addition, Subtraktion, Multiplikation, Division (keine Ganzzahldivision) und Negationsoperatoren. Diese Varianten besitzen fünf als published deklarierte Eigenschaften: Real, Imaginary, Radius, Theta und FixedTheta. Typumwandlungen aus und in Integertypen, Gleitkommatypen, Stringtypen, TDateTime-Werte und boolesche Werte sind möglich. Zusätzlich implementiert die Unit VarCmplx eine Reihe globaler Funktionen für Operationen mit komplexen Varianten.

Siehe auch