arraymerge(
arraymerge(
ARRAY1
,
ARRAY2
,
SEPARATOR
,
JOINER
)

The arraymerge( function merges two text arrays together (see Text Arrays).

Parameters

This function has four parameters:

array1 – is the first text array.

array2 – is the first second array.

separator – is the separator character for both arrays (both must use the same separator character). This should be a single character.

joiner – is the text that will be used to join the individual elements of the two arrays. If the joiner is empty ("") then the elements will simply be appended.

Description

The arraymerge( function merges two text arrays together, item by item (see Text Arrays). In other words, the first element of the first array is merged with the first element of the second array, then the second elements of each array are merged, then the third elements, fourth elements, etc.

    arraymerge("1,2,3","red,green,blue,orange,black",",",":") ☞ 1:red,2:green,3:blue,:orange,:black"
    arraymerge("1,2,3,4,5,6","Gold,Silver,Bronze",",",". ") ☞ 1. Gold,2. Silver,3. Bronze,4. ,5. ,6. "
    arraymerge("1,2,3","A,B,C",",","") ☞ 1A,2B,3C

See Also

- array( -- extracts a single data item from a text array or a data array (see Text Arrays and Data Arrays).
- arrayelement( -- converts between character positions and array element numbers in a text array.
- arrayrange( -- extracts a series of data items from a text array or a data array (see Text Arrays and Data Arrays).
- arraysearch( -- searches a text array or a data array (see Text Arrays and Data Arrays) to see if it contains a specific value.
- arraysize( -- returns the number of elements in a text array or a data array (see Text Arrays and Data Arrays).
- extract( -- extracts a single data item from a text array, and can also be used to count the number of items in the array.
- Text Arrays -- A numbered collection of text values.

History

Version | Status | Notes
10.0 | Updated | Carried over from Panorama 6.0, but the joiner text is no longer limited to 10 characters.