Vector.ArcSec Method

Overload List

#SignatureDescription
1function ArcSec: TMtxVec;Inverse secant.
└ indexed: function ArcSec(Index: Integer; Len: Integer): TMtxVec;
2function ArcSec(const X: TMtxVec): TMtxVec;Calculate the inverse secant of all X object elements.
└ indexed: function ArcSec(const X: TMtxVec; XIndex: Integer; Index: Integer; Len: Integer): TMtxVec;

Overload 1: function ArcSec: TMtxVec;

Inverse secant.

Result: stored in self (calling object), returns self for chaining

Remarks:

Calculate the inverse secant for all calling object elements in-place.

Examples
var
    a, expected: Vector;
begin
    a := [1.0, 1.5, 2.0, 3.0];
    a.ArcSec;
    expected := [0.0, 0.84106867056793, 1.0471975511966, 1.23095941734077];
    if not a.IsEqual(expected, 1e-10, TCompare.cmpAbsolute) then
        raise Exception.Create('Vector.ArcSec: mismatch');
end;
See Also: Vector.Sec, Vector.ArcCsc

Indexed: function ArcSec(Index: Integer; Len: Integer): TMtxVec;

Calculate the inverse secant of calling object elements [Index]...[Index+Len-1] in-place.

#NameTypeDescription
1IndexIntegerstart index
2LenIntegerelement count

Result: stored in self (calling object), returns self for chaining

Remarks:

An exception is raised if array borders are overrun.

Overload 2: function ArcSec(const X: TMtxVec): TMtxVec;

Calculate the inverse secant of all X object elements.

#NameTypeDescription
1XTMtxVec

Result: stored in self (calling object), returns self for chaining

Remarks:

Store the results in the calling object. Size and Vector.Complex properties of calling object are adjusted automatically.

Examples
var
    a, x, expected: Vector;
begin
    x := [1.0, 1.5, 2.0, 3.0];
    a.ArcSec(x);
    expected := [0.0, 0.84106867056793, 1.0471975511966, 1.23095941734077];
    if not a.IsEqual(expected, 1e-10, TCompare.cmpAbsolute) then
        raise Exception.Create('Vector.ArcSec: mismatch');
end;

Indexed: function ArcSec(const X: TMtxVec; XIndex: Integer; Index: Integer; Len: Integer): TMtxVec;

Calculate the inverse secant of X object elements [XIndex]...[XIndex+Len-1].

#NameTypeDescription
1XTMtxVec
2XIndexIntegerX start index
3IndexIntegerstart index
4LenIntegerelement count

Result: stored in self (calling object), returns self for chaining

Remarks:

The results are stored in calling object elements [Index]...[Index+Len-1]. Size and Vector.Complex properties of the calling object must be set explicitly. An exception is raised if array borders are overrun.