arrayinsert(
TEXT
,
ITEM
,
COUNT
,
SEPARATOR
)

The arrayinsert( function inserts one or more empty elements into the middle of a text array (see Text Arrays).


Parameters

This function has four parameters:

text – The text array into which you will insert the new elements.

item – The spot where you want to insert new array elements. The first item is 1, the second item is 2, the third is 3, etc., or you can use negative values, –1 (last item), –2 (second to last, etc.)

count – The number of blank array elements you want to insert.

separator – Is the separator character for this array.


Description

The arrayinsert( function inserts one or more elements in to the middle of a text array (see Text Arrays). The output array will be longer than the input array.

arrayinsert("red,green,blue,orange,white",2,1,",") ☞ red,,green,blue,orange,white
arrayinsert("red,green,blue,orange,white",3,2,",") ☞ red,green,,,blue,orange,white
arrayinsert("red,green,blue,orange,white",-1,1,",") ☞ red,green,blue,orange,,white

The new array elements created by this function are blank, you can fill them in with the arraychange( function.


See Also


History

VersionStatusNotes
10.0UpdatedCarried over from Panorama 6.0, but the item number can now be negative to designate that it should be counted from the end of the string instead of from the beginning.