Overload List
| # | Signature | Description |
|---|---|---|
| 1 | procedure SetSubRangeLevel(const Src: TMtxVecBase; Index: Integer; Len: Integer); | Defines a sub vector/matrix of Src and pushes any previous subranges on to a stack. |
| 2 | procedure SetSubRangeLevel(Index: Integer; Len: Integer); | Defines a sub vector/matrix and pushes any previous subranges on to a stack. |
Overload 1: procedure SetSubRangeLevel(const Src: TMtxVecBase; Index: Integer; Len: Integer);
Defines a sub vector/matrix of Src and pushes any previous subranges on to a stack.
| # | Name | Type | Description |
|---|---|---|---|
| 1 | Src | TMtxVecBase | source TVec, TMtx, TVecInt or TMtxInt |
| 2 | Index | Integer | start index |
| 3 | Len | Integer | element count |
Result: stored in self (calling object)
The method will define a subarray starting at Index and ending at Index+Len-1 of Src. No copying will occur, only pointers will be shifted or indices adjusted. The routine allows for stack based pushing and poping of sub-ranges with the additional constraint that each deepening of the sub-range is strictly within the bounds of the previous one. The pairs of SetSubRangeLevel/SetFullRangeLevel need to match.
All values of the original TMtxVecBase will be preserved. An exception will be raised, if an attempt is made to change the size of calling object. No exception will be raised, if Src is resized while subranged. (possibly leading to memory overwrites)
It is possible to call SetSubRange/SetFullRange on the object, which has been subranged with SetSubRangeLevel.
To again obtain a view of the previous subrange level on the vector/matrix, call TMtxVecBase.SetFullRangeLevel
The Index parameter of the SetSubRange is always relative to the previous, if any, stack level. The Index parameter for the SetSubRangeLevel is relative to the current stack level.
Overload 2: procedure SetSubRangeLevel(Index: Integer; Len: Integer);
Defines a sub vector/matrix and pushes any previous subranges on to a stack.
| # | Name | Type | Description |
|---|---|---|---|
| 1 | Index | Integer | start index |
| 2 | Len | Integer | element count |
Result: stored in self (calling object)
The method will define a subarray starting at Index and ending at Index+Len-1. No copying will occur, only pointers will be shifted or indices adjusted. The routine allows for stack based pushing and poping of sub-ranges with the additional constraint that each deepening of the sub-range is strictly within the bounds of the previous one. The pairs of SetSubRangeLevel/SetFullRangeLevel need to match.
All values of the original TMtxVecBase will be preserved. An exception will be raised, if an attempt is made to change the size of calling object.
It is possible to call SetSubRange/SetFullRange on the object, which has been subranged with SetSubRangeLevel.
To again obtain a view of the previous subrange level on the vector/matrix, call TMtxVecBase.SetFullRangeLevel
The Index parameter of the SetSubRange is absolute for the original memory or current stack level. The Index parameter for the SetSubRangeLevel is relative to the previous SetSubRangeLevel call.