TMtxInt.Reverse Method

TMtxInt Class

Overload List

#SignatureDescription
1function Reverse(Vec: TMtxVecInt; VecIndex: Integer; Index: Integer; Len: Integer): TMtxVecInt;Reverse vector elements.
2function Reverse(Index: Integer; Len: Integer): TMtxVecInt;Reverses the calling object elements [Index]..[Index+Len-1].

Overload 1: function Reverse(Vec: TMtxVecInt; VecIndex: Integer; Index: Integer; Len: Integer): TMtxVecInt;

Reverse vector elements.

#NameTypeDescription
1VecTMtxVecIntsource TVecInt or TMtxInt
2VecIndexInteger
3IndexIntegerstart index
4LenIntegerelement count

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

Remarks:

The method reverses Vec vector elements from [VecIndex].. [VecIndex+Len-1] and stores them in the calling vector from [Index]...[Index+Len-1] by using the following equation:

V[k]=Vec[N−k],0≤k≤N,where N=Vec.Length−1\text{V}[k]=\text{Vec}[N-k],\quad 0\leq k \leq N, \quad \text{where } N=\text{Vec.Length}-1

This overload reverses calling vector elements in-place.

Examples
var
    a: TMtxInt;
begin
MtxVecInt.CreateIt(out a);
try
a.SetIt(2,2, new int[] {1,2,3,4});
a.Reverse;   // a = [2,1,3,4]
finally
MtxVecInt.FreeIt(ref a);
end;
end;

Overload 2: function Reverse(Index: Integer; Len: Integer): TMtxVecInt;

Reverses the calling object elements [Index]..[Index+Len-1].

#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.