MatrixInt.Copy Method

Overload List

#	Signature	Description
1	function Copy(const Mtx: TMtxInt; MtxRow: Integer; MtxCol: Integer; Row: Integer; Col: Integer; NrRows: Integer; NrCols: Integer; Transpose: Boolean): TMtxInt;	Copy the Mtx elements [MtxRow,MtxCol]..[MtxRow+NrRows-1,MtxCol+NrCols-1] to the calling matrix elements [Row,Col],,[Row+NrRows-1,Col+NrCols-1].
2	function Copy(const Src: TMtxVecInt): TMtxVecInt;	Copy object values.
	└ indexed: function Copy(const Src: TMtxVecInt; const SrcIndex: Integer; const Index: Integer; const Len: Integer): TMtxVecInt;

Overload 1: function Copy(const Mtx: TMtxInt; MtxRow: Integer; MtxCol: Integer; Row: Integer; Col: Integer; NrRows: Integer; NrCols: Integer; Transpose: Boolean): TMtxInt;

Copy the Mtx elements [MtxRow,MtxCol]..[MtxRow+NrRows-1,MtxCol+NrCols-1] to the calling matrix elements [Row,Col],,[Row+NrRows-1,Col+NrCols-1].

#	Name	Type
1	Mtx	TMtxInt
2	MtxRow	Integer
3	MtxCol	Integer
4	Row	Integer
5	Col	Integer
6	NrRows	Integer
7	NrCols	Integer
8	Transpose	Boolean

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

Remarks:

An exception is raised if TMtxVecBase.ConditionCheck is true and bounds are overrun. If Transpose is true, the matrix is transposed as well.

Overload 2: function Copy(const Src: TMtxVecInt): TMtxVecInt;

Copy object values.

#	Name	Type	Description
1	Src	TMtxVecInt

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

Remarks:

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

Examples

begin
    TMtxVecInt a,b,c;
    a = new TMtxVecInt();
    b = new TMtxVecInt();
    a.SetIt(new int[] {1,2,3,4});  // a = [1,2,3,4] i.e 1+2i ; 3+4i
    b.Copy(a);                // b = [1,2,3,4]
end;

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

Copy Src elements [SrcIndex]..[SrcIndex+Len-1] in the calling object elements [Index]..[Index+Len-1].

#	Name	Type	Description
1	Src	TMtxVecInt
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:

Calling vector MatrixInt.Size must be set explicitly. An exception is raised if array borders are overrun or underrun.