Insert - method of the PmArray object

Description:

Adds one or multiple items into the array. The array is enlarged by the added items.
It is functional only for 1-dimensional array.

Syntax:

Empty Insert(Long nPos, Variant vValues, [Long nAttr])

Parameters:

nPos	(Long) The index of an item to be added. The current item on this index and following items will be shifted behind the added items. The -2 value means adding to the end.
vValues	(Variant) Added value or array of added values.
nAttr	[optional] (Long) This parameter specifies the behavior if the value of the vValues parameter contains 1-dimensional array. 0 (default) - The content of the vValues parameter is always added as a single item. 1 - If the vValues parameter contains 1-dimensional array then individual items of such array are added (multiple items are added at once). Otherwise the value of the vValues parameter is added as a sigle item.

Note:

The Insert method allows adding items to the beginning, to the end and aslo to the inside of an existing array and the Remove method allows removing items from beginning, from the end and aslo from the inside of an existing array.

This method is also functional in Web panels.

Example:

Adds a2 array into a1 aeeay to position 2

JavaScriptSelect and copy to clipboard



var a1 = Pm.CreatePmArray().Array1(0, 10, 20, 30);

var a2 = Pm.CreatePmArray().Array1(12, 13, 14);

a1.Insert(2, a2, 0);
  // Result: (0, 10, (12, 13, 14), 20, 30)

// or

a1.Insert(2, a2, 1);
  // Result: (0, 10, 12, 13, 14, 20, 30)