TVec.Copy Method — Dew Math

Overload List

#	Signature	Description
1	TVec Copy(TMtxVec Vec1, TMtxVec Vec2)	Copies values from Vec1 and Vec2 (concatenate).
2	TMtxVec Copy(TMtxVec Src)	Copy object values.
	└ indexed: TMtxVec Copy(TMtxVec Vec, Int32 VecIndex, Int32 Index, Int32 Len)
3	TMtxVec Copy(TMtxVec Src, TMtxFloatPrecision dstFloatPrecision)	Copy object values.
4	TMtxVec Copy(TMtxVecInt Src, TMtxFloatPrecision dstFloatPrecision)	Copy and convert values from TVecInt.
5	TMtxVec Copy(TMtxVecInt Src, Int32 SrcIndex, Int32 Index, Int32 Len)	Copy and convert values from TVecInt at indexes [SrcIndex]...[SrcIndex+Len-1].

Overload 1: TVec Copy(TMtxVec Vec1, TMtxVec Vec2)

Copies values from Vec1 and Vec2 (concatenate).

#	Name	Type	Description
1	Vec1	TMtxVec	source TVec or TMtx
2	Vec2	TMtxVec	source TVec or TMtx

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

Remarks:

Copy each of Vec1 and Vec2 elements to the calling vector (concatenate). The Dew.Math.TMtxVecBase.Length and Dew.Math.TMtxVec.Complex properties of the calling vector are set implicitly to match Vec1 and Vec2 vector.

Examples

TVec a;
TVec b;
TVec c;
MtxVec.CreateIt(out a, out b, out c);
try
    {
        a.SetIt(true,new double[] {1,2,3,4});
        b.Copy(a);
        c.Copy(a,b);  //concatenate a and b and store in c
        // c = [1,2,3,4,1,2,3,4]
    }
finally
    {
        MtxVec.FreeIt(ref a, ref b, ref c);
    }

See Also: TVec.Assign, TVec.CopyMtx

Overload 2: TMtxVec Copy(TMtxVec Src)

Copy object values.

#	Name	Type	Description
1	Src	TMtxVec	source TVec or TMtx

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

Remarks:

Copy each of Vec elements to the calling object. Size and Dew.Math.TMtxVec.Complex properties of the calling object are set implicitly to match Vec object.

Examples

Vector a = new Vector();
Vector x = new Vector();
x.SetIt(new double[] { 1.0, 2.0, 3.0, 4.0 });
a.Copy(x);
if (!a.IsEqual(x, 1e-10, TCompare.cmpAbsolute))
    throw new Exception("Vector.Copy: mismatch");

Vector a;
Vector b;
Vector c;
a.SetIt(true,new double[] {1,2,3,4});  // a = new double[] {1,2,3,4}
b.Copy(a);                // b = new double[] {1,2,3,4}
c.Copy(a,b);  //concatenate a and b and store in c = new double[] {1,2,3,4,1,2,3,4}

Indexed: TMtxVec Copy(TMtxVec Vec, Int32 VecIndex, Int32 Index, Int32 Len)

Copy Vec elements [VecIndex]..[VecIndex+Len-1] in the calling object elements [Index]..[Index+Len-1].

#	Name	Type	Description
1	Vec	TMtxVec	source TVec or TMtx
2	VecIndex	Int32
3	Index	Int32	start index
4	Len	Int32	element count

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

Remarks:

Size and Dew.Math.TMtxVec.Complex properties must be set explicitly. An exception is raised if Dew.Math.TMtxVecBase.ConditionCheck is True and array borders are overrun or underrun.

Overload 3: TMtxVec Copy(TMtxVec Src, TMtxFloatPrecision dstFloatPrecision)

Copy object values.

#	Name	Type	Description
1	Src	TMtxVec	source TVec or TMtx
2	dstFloatPrecision	TMtxFloatPrecision

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

Remarks:

Copy each of Vec elements to the calling object. Size and Dew.Math.TMtxVec.Complex properties of the calling object are set implicitly to match Vec object.

Examples

using Dew.Math;
using Dew.Math.Units;

namespace Dew.Examples
{
    void Example()
    {
        TVec a,b,c;
        MtxVec.CreateIt(out a, out b, out c);
        try
        {
            a.SetIt(true,new double[] {1,2,3,4});  // a = [1,2,3,4] i.e 1+2i ; 3+4i
            b.Copy(a, mvSingle);                // convert to single precision
        }
        finally
        {
            MtxVec.FreeIt(ref a,ref b,ref c);
        }
    }
}

Overload 4: TMtxVec Copy(TMtxVecInt Src, TMtxFloatPrecision dstFloatPrecision)

Copy and convert values from TVecInt.

#	Name	Type	Description
1	Src	TMtxVecInt	source TVecInt or TMtxInt
2	dstFloatPrecision	TMtxFloatPrecision

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

Remarks:

Applies appropriate conversion and copy data from TVecInt. The destinaton data format is determined with dstFloatPrecision.

Overload 5: TMtxVec Copy(TMtxVecInt Src, Int32 SrcIndex, Int32 Index, Int32 Len)

Copy and convert values from TVecInt at indexes [SrcIndex]...[SrcIndex+Len-1].

#	Name	Type	Description
1	Src	TMtxVecInt	source TVecInt or TMtxInt
2	SrcIndex	Int32	source start index
3	Index	Int32	start index
4	Len	Int32	element count

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

Remarks:

Applies appropriate conversion and copy data from TVecInt. The results are stored in calling object elements [Index]...[Index+Len-1]. Size and Dew.Math.TMtxVec.Complex properties of the calling object must be set explicitly. An exception is raised if array borders are overrun.