Description
MoveArray allows you move elements from an array to array.The MoveArray has 5 parameters, one of which is optional. When moving an array, padding usually means it will clear out the remaining elements on the target after it does the moving. There is also no option to move right, it will always be move left.
Parameters
- From array name
- From array index (as string, can be variable) - 1 or higher, start from this index when working with the source.
- Target array name
- Target array index (as string, can be variable) - 1 or higher, start from this index when working with the target.
- Padding - if true, the target will be padded. Can be null.
...
- .
Example
Example 1: array -> array
| Code Block |
|---|
|
pjs.define("ARRX", { type: 'char', length: 5, dim: 5, initValue: 'Hi' }); |
...
pjs.define("ARRY", { type: 'char', length: 5, dim: 10, initValue: 'Test' }); |
...
pjs.MoveArray("ARRX", "1", "ARRY", "1", false); |
...
...
...
...
...
...
...
','Test ','Test ','Test ','Test ','Test ' |
Example 2: char -> array
| Code Block |
|---|
|
pjs.define("CHAR", { type: 'char', length: 5, initValue: 'Hello' }); |
...
pjs.define("ARRY", { type: 'char', length: 1, dim: 10 }); |
...
pjs.MoveArray("CHAR", "1", "ARRY", "1"); |
...
...
//'H','e','l','l','o',' ',' ',' ',' ',' ' |
...
Example 3: array -> array (with source index)
In this example, we are moving ARRX into ARRY. Since the second parameter is 3, this means it will start the move from the 3rd element (skipping the first two) which results in only 3 elements being moved.
| Code Block |
|---|
|
pjs.define("ARRX", { type: 'char', length: 5, dim: 5, initValue: 'Test' }); |
...
pjs.define("ARRY", { type: 'char', length: 5, dim: 10, initValue: '' }); |
...
pjs.MoveArray("ARRX", "3", "ARRY", "1"); |
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
Example 4: array -> array (with target index)
This example shows a value of 6 on the 4th parameter. Because the 4th parameter indicates where the index is going to start on the target (ARRY), it's going to move elements into this array starting from the 6th element.
| Code Block |
|---|
|
pjs.define("ARRX", { type: 'char', length: 5, dim: 5, initValue: 'ABCD' }); |
...
pjs.define("ARRY", { type: 'char', length: 5, dim: 10, initValue: 'EFGH' }); |
...
pjs.MoveArray("ARRX", "1", "ARRY", "6"); |
...
...
//'EFGH ','EFGH ','EFGH ','EFGH ','EFGH ','ABCD ','ABCD ','ABCD ','ABCD ','ABCD ' |
Example 5: character const -> flags array
In this example, we're going to move a const ('111111') into flags, starting at element 71. This means elements 71, through to 76 in flags will be set to true. (since 1 is true, 0 would be false)
| Code Block |
|---|
|
pjs.define("someInd", { type: 'boolean', initValue: true }); |
...
pjs.MoveArray("'111111'", "1", "flags", "71"); |
...
...
Example 6: array -> character field
| Code Block |
|---|
|
pjs.define("ARRX", { type: 'char', length: 2, dim: 5, initValue: 'AB' }); |
...
pjs.define("CHAR", { type: 'char', length: 10 }); |
...
pjs.MoveArray("ARRX", "1", "CHAR", "1"); |
...
...