Math

Common mathematical operations.

Definitions:

String Types:

Comparison: Used when comparing values.

Commands:

Absolute value: Remove the sign from a value and return its positive value.
Add:value: Add two numbers and return the result.
Decrease:[by:] Decrease a stored value and, optionally, return the new value.
Divide:value: Divide one number by another and return the result.
Increase:[by:] Increase a stored value and, optionally, return the new value.
Is:matching:num:[within:] Compare two numbers.
Is:matching:text: Compare two text values in "lexical" ( alphabetical ) order.
Is:matching:value: Compare two values.
Mod:value: Divide one number by another and return the remainder.
Multiply:value: Multiply two numbers and return the result.
Subtract:value: Subtract two numbers and return the result.

String Types

Comparison

Used when comparing values. The options are:

"equal_to"
"other_than"
"greater_than"
"less_than"
"at_least"
"at_most"

Commands

Absolute value:

Remove the sign from a value and return its positive value.

Slots:

NumEval

Terms:

value:

NumEval

The value to normalize.

Add:value:

Add two numbers and return the result.

Slots:

NumEval

Terms:

Add:	NumEval	The augend.
value:	NumEval	The addend.

Decrease:[by:]

Decrease a stored value and, optionally, return the new value.

Slots:

Terms:

Decrease:	Address	A reference to the value to decrease. This reads and writes to that value.
by: optional	NumEval	if not specified, decrements by 1.

Divide:value:

Divide one number by another and return the result.

Slots:

NumEval

Terms:

Divide:	NumEval	The numerator.
value:	NumEval	The divisor.

Increase:[by:]

Increase a stored value and, optionally, return the new value.

Slots:

Terms:

Increase:	Address	A reference to the value to increase. This reads and writes to that value.
by: optional	NumEval	If not specified, increments by 1.

Is:matching:num:[within:]

Compare two numbers.

Slots:

BoolEval

Terms:

Is:	NumEval	The first number.
matching:	Comparison	The specific way to compare the two numbers.
num:	NumEval	The second number.
within: optional	Num	A positive value to indicate how close the two numbers can be.

Is:matching:text:

Compare two text values in "lexical" ( alphabetical ) order.

Slots:

BoolEval

Terms:

Is:	TextEval	The first text value.
matching:	Comparison	The specific way to compare the two text values.
text:	TextEval	The second text value.

Is:matching:value:

Compare two values. If the two values are of different types, this will attempt -- in a limited way -- to coerce the second value to match the type of the first value before comparing them.

Any value can be coerced to bool ( following the truthiness rules for [IsValue] ), and bool and num values can be coerced into text. Otherwise, the types of the values must match exactly.

Numbers are compared using an internally determined default tolerance. To control the tolerance between numbers, use [CompareNum].

Slots:

BoolEval

Terms:

Is:	Assignment	The first value. If needed, the second value will coerced to match the type of the first.
matching:	Comparison	The specific way to compare the two values.
value:	Assignment	The first value. If needed, this value will coerced to match the type of the first value.