AMT Datasouth PAL - Manual (Page 159)

153
putinterval
putinterval
Description
Store a range of data into an array or string object.
Usage
AnyArray IndexInt SubArray putinterval
AnyStr IndexInt SubStr putinterval
AnyArray Array. Array object to receive sub-array objects.
AnyStr String. String object to receive sub-string characters.
IndexInt Integer. When used with AnyArray, index of first data object to replace within
array. Arrays begin with index zero. When used with AnyStr, index of first
character to replace within string. Strings begin with index zero.
SubArray Array. Array containing objects to replace sub-range within AnyArray.
SubStr Any. String containing characters to replace sub-range within AnyStr.
Comments
In the first variant, the operator replaces objects starting at index IndexInt within the array
AnyArray. The replacement continues for the number of elements in SubArray. Array indexes
range from zero to N-1, where N is the number of elements in the array. The operator replaces the
AnyArray objects with duplicates of objects in the array SubArray. For composite objects, the
duplicate objects share their data with the original objects in the SubArray.
In the second variant, the operator replaces characters starting at index IndexInt within the string
AnyStr. The replacement continues for the number of characters in SubStr. String character
indexes range from zero to N-1, where N is the number of characters in the string. The operator
replaces the AnyStr characters with the characters from SubStr.