Inserts the specified number of elements from a source array to a receiving one starting from a specified index.
[in][out] Receiving array the elements should be added to.
[in] Source array the elements are to be added from.
[in] Index in the receiving array for inserting elements from the source array.
[in] Index in the receiving array, starting from which the elements of the source array are taken for insertion.
[in] Number of elements to be added from the source array. The WHOLE_ARRAY means all elements from the specified index up to the end of the array.
Returns true if successful, otherwise - false. To get information about the error, call the GetLastError() function. Possible errors:
If the function is used for a fixed-size array, the size of the dst_array receiving array itself does not change. Starting from the dst_start position, the elements of the receiving array are shifted to the right (the last counts of the elements "come off"), while the elements copied from the source array take their place.
You cannot insert the elements to the dynamic arrays designated as the indicator buffers by the SetIndexBuffer() function. For indicator buffers, all size changing operations are performed by the terminal's executing subsystem.
In the source array, the elements are copied starting from the src_start index. The source array size remains unchanged. The elements to be added to the receiving array are not links to the source array elements. This means that subsequent changes of the elements in any of the two arrays are not reflected in the second one.