Differences

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

--- token:Calculate [2015/12/13 10:13] – Updated to add formula choices, and clarify use of arrays JMichaelTX
+++ token:Calculate [2023/11/10 03:29] (current) – peternlewis
@@ Line 1: / Line 1: @@
-{{:token:calculator-icon.png |}}===== Calculate Token =====
+===== 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:
   * 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)]]
-  * 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\\
   * %Variable%MyVar% will return `005`
   * %Calculate%MyVar% will return `5`
+===== See Also =====
+==== Actions ====
+* [[action:Set_Variable_to_Calculation|Set Variable to Calculation]] action
+* [[:Actions|See all Actions]]
+=== Tokens ===
+* [[token:CalculateFormat|%CalculateFormat%]] token
+* [[/Tokens|All Tokens]]