JCL Help:TJclComplex.CDiv@Float@Float@TComplexKind

From Project JEDI Wiki
Jump to navigationJump to search


Summary

Divide the value of the current complex number object by the value given by DivValue or X and Y parameters.


Pascal

 public function CDiv(const DivValue: TJclComplex): TJclComplex; overload;
public function CDiv(const X: Float; const Y: Float; const ComplexType: TComplexKind = crRectangular): TJclComplex; overload;


Parameters

Parameters Description
const DivValue: TJclComplex The complex number that is the denominator for the operation.
const X: Float The real part in the rectangular representation or radius in polar coordinates of the complex number that is the denominator for the operation.
const Y: Float The imaginary part in the rectangular representation or angle in polar coordinates of the complex number that is the denominator for the operation.
const ComplexType: TComplexKind = crRectangular Optional. Defines whether X and Y parameters are stated in rectangular representation or in polar coordinates.


Return Value

Method CDiv returns the calling object with the changed value.


Description

Use CDiv method to perform a division operation where the current complex number object is a numerator and the value provided through either X and Y or DivValue parameters is a denominator. The complex number to be divided by could be set either as an object of TJclComplex type or a pair of its values (X;Y).


See Also

CNewDiv TJclComplex TComplexKind


About

Donator

Earl F. Glynn


Notes

The division of the complex numbers is performed according to the following formula: (X1;Y1) / (X2;Y2) = [(X1 *X2+Y1*Y2)/(X22+Y22); (Y1*X2-X1*Y2)/ (X22+Y22)]. For leaving the value of the calling object intact use CNewDiv method to create a new resulting object of TJclComplex type.


Contribute to this help topic

This documentation wiki is based on the collaborative effort of Project JEDI users. Your edits are welcome in order to improve documentation quality: edit this page