This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
token:Calculate [2015/07/15 06:26] peternlewis |
token:Calculate [2017/09/04 23:56] peternlewis |
||
---|---|---|---|
Line 1: | Line 1: | ||
- | The //%Calculate%1+2%// token returns the result of performing a calculation. | + | {{:token:calculator-icon.png |}}===== Calculate Token ===== |
- | This allows you to include any [function](:Functions) in a text field. | + | The //%Calculate%//**<formula>**//%// [[:Tokens|token]] returns the **numeric** result of performing a calculation, |
+ | where //**`<formula>`**// may be any of the following: | ||
+ | * Mathematical formula like `(2 + 3)*12` | ||
+ | * Use any [[token:Variable|Variable]] which may be evaluated as a number | ||
+ | * :!: Just enter the Variable Name (without the `%`) in the Calculate token **`<formula>`** | ||
+ | * Examples: | ||
+ | * `%Calculate%MyVar + 1%` | ||
+ | * `%Calculate%(MyVarWordsPerSec * 60)/MyVarWordsPerPage%` | ||
+ | * Use any of the built-in Keyboard Maestro [functions](:Functions), like [[function:RANDOM|RANDOM(10)]] | ||
+ | * Get the numeric value of an Variable array element, like `MyVar[2]`, if MyVar is `10,05,12,08` returns `5` (Arrays may contain only numeric data) | ||
- | Remember that within a calculation you can use variables unadorned. So for a variable “Count” that has a numerical value, these two are roughly equivalent in a text field: | + | **Example Action** |
+ | |||
+ | {{:token:km-7.3-calculate-token-example.png?nolink|}} | ||
+ | |||
+ | A reminder that the following are only equivalent if the [[token:Variable|Variable]] is numeric: | ||
+ | |||
+ | * %Variable%Count% (Variable) | ||
+ | * %Calculate%Count% (Number) | ||
+ | |||
+ | So, if MyVar is "`005`", then\\ | ||
+ | * %Variable%MyVar% will return `005` | ||
+ | * %Calculate%MyVar% will return `5` | ||
- | * [%Variable%Var%](Variable) | ||
- | * %Calculate%Var% | ||
- | A notable different would be if the variable had a value like “1.230”. Then the result of the //%Calculate%// would be “1.23”. |