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/12/13 05:13] JMichaelTX Updated to add formula choices, and clarify use of arrays |
token:Calculate [2017/09/05 01:24] peternlewis [See Also] |
||
---|---|---|---|
Line 1: | Line 1: | ||
- | {{:token:calculator-icon.png |}}===== Calculate Token ===== | + | {{:token:calculator-icon.png |}} |
+ | ===== Calculate Token ===== | ||
- | The //%Calculate%//**<formula>**//%// token returns the **numeric** result of performing a calculation,\\ | + | The //%Calculate%//**<formula>**//%// [[:Tokens|token]] returns the **numeric** result of performing a calculation, |
where //**`<formula>`**// may be any of the following: | where //**`<formula>`**// may be any of the following: | ||
* Mathematical formula like `(2 + 3)*12` | * Mathematical formula like `(2 + 3)*12` | ||
- | * Use any Variable which may be evaluated as a number, like\\ `(MyVarWordsPerSec * 60)/MyVarWordsPerPage` would yield the number of pages per minute | + | * 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)]] | * 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]`\\ "`10,05,12,08`" returns "`5`" \\ (Arrays may contain only numeric data) | + | * 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) |
- | A reminder that the following are only equivalent if the Variable is numeric: | + | The //%Hex2%// token (v8+) returns the value in Hex format, padded with zeros to two digits. "2" is just an example, you can use //%Hex8%// for example. |
- | * [%Variable%Count%](Variable) | + | The //%Dec2%// token (v8+) returns the value in decimal format, padded with zeros to two digits (similarly //%Dec5%// to five digits, etc). |
- | * %Calculate%Count% | + | |
+ | The //%Oct3%// token (v8+) returns the value in octal format, padded with zeros to three digits (similarly //% Oct5%// to five digits, etc). | ||
+ | |||
+ | The //%Bin8%// token (v8+) returns the value in binary format, padded with zeros to eight digits (similarly //% Bin16%// to 16 digits digits, etc). | ||
+ | |||
+ | **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\\ | So, if MyVar is "`005`", then\\ | ||
* %Variable%MyVar% will return `005` | * %Variable%MyVar% will return `005` | ||
* %Calculate%MyVar% will return `5` | * %Calculate%MyVar% will return `5` | ||
+ | |||
+ | ===== See Also ===== | ||
+ | |||
+ | === Tokens === | ||
+ | |||
+ | * [[token:CalculateFormat|%CalculateFormat%]] token | ||
+ | * [[/Tokens|All Tokens]] |