TVecInt.Reverse Method

TVecInt Class

Overload List

#SignatureDescription
1TVecInt ReverseReverse vector elements.
└ indexed: TMtxVecInt Reverse(Int32 Index, Int32 Len)
2TVecInt Reverse(TMtxVecInt Vec)Reverse all Vec elements.
└ indexed: TMtxVecInt Reverse(TMtxVecInt Vec, Int32 VecIndex, Int32 Index, Int32 Len)

Overload 1: TVecInt Reverse

Reverse vector elements.

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

Remarks:

The method reverses vector elements 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 all calling vector elements in-place.

Examples
TVecInt a;
MtxVec.CreateIt(out a);
try
    {
        a.SetIt(new double[] {1,2,3,4});
        a.Reverse;   // a = new double[] {4,3,2,1}
    }
finally
    {
        MtxVec.FreeIt(ref a);
    }
See Also: TVecInt.Rotate, TVecInt.Shift

Indexed: TMtxVecInt Reverse(Int32 Index, Int32 Len)

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

#NameTypeDescription
1IndexInt32start index
2LenInt32element count

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

Remarks:

An exception is raised if array borders are overrun.

Overload 2: TVecInt Reverse(TMtxVecInt Vec)

Reverse all Vec elements.

#NameTypeDescription
1VecTMtxVecIntsource TVecInt or TMtxInt

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

Remarks:

Xtore the result in the calling vector elements. The Dew.Math.TMtxVecBase.Length property of the calling vector are set implicitly to match Vec vector.

Indexed: TMtxVecInt Reverse(TMtxVecInt Vec, Int32 VecIndex, Int32 Index, Int32 Len)

Reverse vector elements.

#NameTypeDescription
1VecTMtxVecIntsource TVecInt or TMtxInt
2VecIndexInt32
3IndexInt32start index
4LenInt32element 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
using Dew.Math;
using Dew.Math.Units;

namespace Dew.Examples
{
    void Example()
    {
        TVecInt a;
        MtxVecInt.CreateIt(out a);
        try
        {
            a.SetIt(new int[] {1,2,3,4});
            a.Reverse();   // a = [4,3,2,1]
        }
        finally
        {
            MtxVecInt.FreeIt(ref a);
        }
    }
}