forked from livecode/livecode
-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathcombine.lcdoc
More file actions
64 lines (39 loc) · 3.21 KB
/
combine.lcdoc
File metadata and controls
64 lines (39 loc) · 3.21 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
Name: combine
Type: command
Syntax: combine array {using | by | with} <primaryDelimiter> [and <secondaryDelimiter>]
Syntax: combine array {using | by | with} <primaryDelimiter> as set
Syntax: combine array {using | by | with} {row | column}
Summary: Transforms an <array> into a list.
Introduced: 1.1
OS: mac,windows,linux,ios,android
Platforms: desktop,server,web,mobile
Example:
combine myArray using comma
Example:
combine myArray by row
Example:
put "apple" into tArray[1]
put "banana" into tArray[2]
combine tArray using return and ":"
## RESULT tArray
## 1:apple
## 2:banana
Parameters:
primaryDelimiter: A character or expression that resolves to a character.
secondaryDelimiter: A character or expression that resolves to a character.
arrayName (array):
The result: If you specify a <secondaryDelimiter>, the key corresponding to each element is added to the element's content, separated from the content by the <secondaryDelimiter>. For example, if the <primaryDelimiter> is return and the <secondaryDelimiter> is tab, each line of the resulting variable contains an element's key, a tab character, and the element's content. If you don't specify a <secondaryDelimiter>, then the keys are lost in the transformation.Combining an array by row converts the array into a table with rows separated by the <rowDelimiter property>. Each row in the resulting string is the contents of the corresponding key in the array.Combining an array by column converts the array into a table with columns separated by the <columnDelimiter property>. Each column of the resulting string is the contents of the corresponding key in the array.
Description:
Use the <combine> command to display an array in a field or to process an array using string operators, functions, and chunk expressions.
The <combine> command combines the elements of the array into a single variable. After the command is finished executing, the variable specified by array is no longer an array.
If the first form of the command is used, the elements of the original array are separated by the <primaryDelimiter>. For example, if the <primaryDelimiter> is return, the content of each element of the original array appears on a separate line.
If you use the as set form the <combine> command rebuilds the list using the delimiter passed, the values of the array are ignored.
>*Note:* The order of the elements is not alphabetical or chronological; it is based on the internal hash order of the array. To alphabetize the list, use the sort command:
combine monthlyReceivables using return and comma
sort lines of monthlyReceivables by item 2 of each
If the second form of the <combine> command is used, the elements of the original array are considered to be either columns or rows, separated by the <columnDelimiter property> or <rowDelimiter property> respectively.
>*Note:* The combine by row and combine by column forms can only be used with numerically keyed arrays
Changes:
The combine by row / column form was added in 2.8.1
References: columnDelimiter (property), columnDelimiter property (property), rowDelimiter property (property), rowDelimiter (property), [] (keyword), using (keyword), split (command), extents (function), keys (function), array (glossary)
Tags: properties