Vector.Copy Method

Overload List

#	Signature	Description
1	function Copy(const Vec: TMtxVec): TMtxVec;	Copy object values.
	└ indexed: function Copy(const Vec: TMtxVec; VecIndex: Integer; Index: Integer; Len: Integer): TMtxVec;
2	function Copy(const Src: TMtxVec; const dstFloatPrecision: TMtxFloatPrecision): TMtxVec;	Copy object values.
3	function Copy(const Vec1: TMtxVec; const Vec2: TMtxVec): TVec;	Copies values from Vec1 and Vec2 (concatenate).
4	function Copy(const Src: TVecInt): TMtxVec;	Copy and convert values from TVecInt.
	└ indexed: function Copy(const Src: TVecInt; SrcIndex: Integer; Index: Integer; Len: Integer): TMtxVec;
5	function Copy(const Src: TVecInt; const dstFloatPrecision: TMtxFloatPrecision): TMtxVec;	Copy and convert values from TVecInt.

Overload 1: function Copy(const Vec: TMtxVec): TMtxVec;

Copy object values.

#	Name	Type	Description
1	Vec	TMtxVec

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

Remarks:

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

Examples

var a,b,c: Vector;
begin
    a.SetIt(True,[1,2,3,4]);  // a = [1,2,3,4]
    b.Copy(a);                // b = [1,2,3,4]
    c.Copy(a,b);  //concatenate a and b and store in c = [1,2,3,4,1,2,3,4]
end;

var
    a, x: Vector;
begin
    x := [1.0, 2.0, 3.0, 4.0];
    a.Copy(x);
    if not a.IsEqual(x, 1e-10, TCompare.cmpAbsolute) then
        raise Exception.Create('Vector.Copy: mismatch');
end;

See Also: Vector.Assign

Indexed: function Copy(const Vec: TMtxVec; VecIndex: Integer; Index: Integer; Len: Integer): TMtxVec;

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

#	Name	Type	Description
1	Vec	TMtxVec
2	VecIndex	Integer
3	Index	Integer	start index
4	Len	Integer	element count

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

Remarks:

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

Overload 2: function Copy(const Src: TMtxVec; const dstFloatPrecision: TMtxFloatPrecision): TMtxVec;

Copy object values.

#	Name	Type	Description
1	Src	TMtxVec
2	dstFloatPrecision	TMtxFloatPrecision

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

Remarks:

Copy each of Src elements to the calling object. Size and Vector.Complex properties of the calling object are set implicitly to match Src object.

Examples

var a,b,c: TVec;
begin
    CreateIt(a,b,c);
    try
        a.SetIt(True,[1,2,3,4]);  // a = [1,2,3,4]
        b.Copy(a, mvSingle);               // convert to single precision
    finally
        FreeIt(a,b,c);
    end;
end;

See Also: Vector.Assign

Overload 3: function Copy(const Vec1: TMtxVec; const Vec2: TMtxVec): TVec;

Copies values from Vec1 and Vec2 (concatenate).

#	Name	Type	Description
1	Vec1	TMtxVec
2	Vec2	TMtxVec

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

Remarks:

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

Examples

var a,b,c: Vector;
begin
    a.SetIt(True,[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]
end;

See Also: Vector.Assign

Overload 4: function Copy(const Src: TVecInt): TMtxVec;

Copy and convert values from TVecInt.

#	Name	Type	Description
1	Src	TVecInt

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

Remarks:

Applies appropriate conversion and copy data from TVecInt. Existing value of FloatPrecision is preserved.

Indexed: function Copy(const Src: TVecInt; SrcIndex: Integer; Index: Integer; Len: Integer): TMtxVec;

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

#	Name	Type	Description
1	Src	TVecInt
2	SrcIndex	Integer	source start index
3	Index	Integer	start index
4	Len	Integer	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 Vector.Complex properties of the calling object must be set explicitly. An exception is raised if array borders are overrun.

Overload 5: function Copy(const Src: TVecInt; const dstFloatPrecision: TMtxFloatPrecision): TMtxVec;

Copy and convert values from TVecInt.

#	Name	Type	Description
1	Src	TVecInt
2	dstFloatPrecision	TMtxFloatPrecision

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

Remarks:

Applies appropriate conversion and copy data from TVecInt.