TMtx.Ceil Method

Overload List

#	Signature	Description
1	function Ceil: TMtxVec;	Rounds towards positive infinity.
	└ indexed: function Ceil(Index: Integer; Len: Integer): TMtxVec;
2	function Ceil(const Src: TMtxVec): TMtxVec;	Rounds all Src object elements towards positive infinity.
	└ indexed: function Ceil(const Src: TMtxVec; SrcIndex: Integer; Index: Integer; Len: Integer): TMtxVec;

Overload 1: function Ceil: TMtxVec;

Rounds towards positive infinity.

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

Remarks:

Rounds all calling object elements towards positive infinity in-place.

Ceil(-2.8) = -2

Ceil(2.8) = 3

Ceil(-1.0) = -1

Examples

var
    a, expected: Matrix;
begin
    a := [[1.2, 2.7], [-0.5, 3.9]];
    a.Ceil;
    expected := [[2.0, 3.0], [-0.0, 4.0]];
    if not a.IsEqual(expected, 1e-10, TCompare.cmpAbsolute) then
        raise Exception.Create('Matrix.Ceil: mismatch');
end;

Indexed: function Ceil(Index: Integer; Len: Integer): TMtxVec;

Rounds calling object elements [Index]..[Index+Len-1] towards positive infinity in-place.

#	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.

Overload 2: function Ceil(const Src: TMtxVec): TMtxVec;

Rounds all Src object elements towards positive infinity.

#	Name	Type	Description
1	Src	TMtxVec	source TVec or TMtx

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

Remarks:

Stores the result in the calling object. Size and TMtxVec.Complex properties of the calling object are adjusted automatically.

Examples

var
    a, x, expected: Matrix;
begin
    x := [[1.2, 2.7], [-0.5, 3.9]];
    a.Ceil(x);
    expected := [[2.0, 3.0], [-0.0, 4.0]];
    if not a.IsEqual(expected, 1e-10, TCompare.cmpAbsolute) then
        raise Exception.Create('Matrix.Ceil: mismatch');
end;

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

Rounds Src object elements [SrcIndex]..[SrcIndex+Len-1] towards positive infinity.

#	Name	Type	Description
1	Src	TMtxVec	source TVec or TMtx
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:

Stores the result in the calling object elements [Index]..[Index+Len-1] Size and TMtxVec.Complex properties of the calling object must be set explicitly. An exception is raised if array borders are overrun.