User Tools

Site Tools


token:Calculate

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Next revision Both sides next revision
token:Calculate [2015/07/24 04:36]
peternlewis
token:Calculate [2017/09/04 23:57]
peternlewis [Calculate Token]
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 (eg //​%Calculate%3 ​Count + 2%//​). ​ So for a variable “Count” that has a numerical value, these two are roughly equivalent in a text field:+**Example Action**
  
-[%Variable%Count%](Variable) +{{:​token:​km-7.3-calculate-token-example.png?​nolink|}} 
-* %Calculate%Count%+ 
 +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` 
 + 
 +===== See Also ===== 
 + 
 +=== Tokens === 
 + 
 +* [[Hex|%Hex%]] token 
 +* [[Dec|%Dec%]] token 
 +* [[Oct|%Oct%]] token 
 +* [[Bin|% Bin%]] token 
 +* [[/​Tokens|All Tokens]]
  
-A notable different would be if the variable had a value like “1.230”. ​ Then the result of the //​%Calculate%//​ would be “1.23”. 
token/Calculate.txt · Last modified: 2023/11/09 22:29 by peternlewis