arrayinsert(
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 into 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

- array( --
- arraydelete( --
- arrayelement( --
- arrayrange( --
- arraysearch( --
- arraysize( --
- extract( --
- Text Arrays -- A numbered collection of text values.

History

Version | Status | Notes
10.0 | Updated | Carried 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.