MatrixInt.Reverse Method

Overload List

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

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

Reverse vector elements.

#	Name	Type	Description
1	Vec	TMtxVecInt
2	VecIndex	Integer
3	Index	Integer	start index
4	Len	Integer	element 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:

\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: MatrixInt;
begin
    a := [[1,2],[3,4]];
    a.Reverse(0,2);   // a = [2,1,3,4]
end;

See Also: MatrixInt.Rotate, MatrixInt.Shift

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

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

#	Name	Type	Description
1	Index	Integer	start index
2	Len	Integer	element count

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

Remarks:

An exception is raised if array borders are overrun.