Differences

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

--- token:Calculate [2015/07/24 04:36]
peternlewis
+++ token:Calculate [2017/09/04 23:55]
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]`\\  "`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**
+{{: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%Count%](Variable)
-* %Calculate%Count%
-A notable different would be if the variable had a value like “1.230”.  Then the result of the //%Calculate%// would be “1.23”.

Keyboard Maestro Wiki

User Tools

Site Tools

Differences

Page Tools