forked from livecode/livecode
-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathdash.lcdoc
More file actions
107 lines (76 loc) · 2.85 KB
/
dash.lcdoc
File metadata and controls
107 lines (76 loc) · 2.85 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
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
Name: -
Type: operator
Syntax: <firstNumber> - <secondNumber>
Syntax: <numberArray> - {<number> | <numberArray>}
Syntax: -<number>
Summary:
Subtracts one number from another, or designates a number as <negative>.
Introduced: 1.0
OS: mac, windows, linux, ios, android
Platforms: desktop, server, mobile
Example:
local myContainer
put -24 into myContainer
Example:
local theRight, theLeft, theWidth
put theRight - theLeft into theWidth
Example:
local myArray, adjustedValues
put myArray - 17 into adjustedValues
Example:
# Assume a card with three fields as named below, and a button.
# Fields "tNumList1" and "tNumList2" each contain return-delimited
# lists of numbers. The button script contains this handler:
on mouseUp
local tNumList1, tNumList2
put fld "list1" into tNumList1
put fld "list2" into tNumList2
split tNumList1 by return
split tNumList2 by return
put tNumList2 - tNumList1 into tNumList1
combine tNumList1 by row
put tNumList1 into fld "subtracted"
end mouseUp
Parameters:
firstNumber:
A number or an expression that evaluates to a number.
secondNumber:
A number or an expression that evaluates to a number.
numberArray (array):
An array whose elements contain numbers.
number:
A number or an expression that evaluates to a number.
Description:
The <-> (minus) <operator> serves two purposes. When it has a single
<operand> (<unary> minus), it negates that number. When it has two
<operand|operands> (<binary> minus), it subtracts the second number
from the first number.
To subtract a number from the contents of a container, use the
<subtract> <command>.
You cannot use the unary minus twice in a row. The expression
- - someNumber
causes an error, and the expression
-- someNumber
is interpreted as a comment because it starts with the comment keyword
<-->.
If <firstNumber> or <secondNumber> is an <array>, each of the <array>
<element(glossary)|elements> must be a number. If a number is
subtracted from an <array>, the number is subtracted from each
<element(glossary)>. If an <array> is subtracted from an <array>, both
<array|arrays> must have the same number of <element(glossary)|elements>
and the same dimension, and each <element(glossary)> in one <array> is
subtracted from the corresponding <element(glossary)> of the other
<array>.
If an element of an array is empty, the <-> <operator> treats its
contents as zero.
The <unary> minus cannot be used with an array.
Changes:
The option to subtract arrays was introduced in version 1.1.
In previous versions, only single numbers could be used with the -
operator.
References: subtract (command), split (command), combine (command),
operand (glossary), operator (glossary), element (glossary),
negative (glossary), binary (glossary), array (glossary),
command (glossary), unary (glossary), -- (keyword), element (keyword),
() (operator), + (operator)
Tags: math