Differences

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

--- token:Variable [2015/07/07 01:08]
peternlewis created
+++ token:Variable [2023/09/12 23:50]
peternlewis
@@ Line 1: / Line 1: @@
-The *Variable* text token (% Variable%) allows you to include a variable in a token text field.  For Example,
+===== Variable Token =====
-Insert Text: Sally said "Hello" to %Variable%First Name%.
+The //%Variable%//`<VariableName>`% token allows you to include a [[manual:Variables|variable]] in a [[:Text Fields |token text field]], where `<VariableName>` is the name of the variable.
-You can also use a short form of just %Variable Name% to include variables as long as the variable exists and has a value and there is no corresponding text token, although generally it is better and clearer to use the longer form %Variable%Variable Name%.
+For Example, using the [[action:Insert_Text|Insert Text]] Action:
+{{ :token:km-wiki-insert-text-action.png?nolink |}}
+You can (v7.2+) access a variable as if it is a comma separated array of text using the notation //%Variable%//`<VariableName>[3]`% where 3 can be any [[manual:Calculations|Calculation]].  You can use a different item separator by putting the text between the ] and % characters, eg //%Variable%//`<VariableName>[3]:`%. In v11+, the separator is processed for backslashes, so you can use //%Variable%//`<VariableName>[3]\n`% to get the 3rd line.  Arrays are indexed starting from 1, and index 0 will give the count of the number of items, negative indices will index from the end of the array.
+You can also use a short form of just //%Variable Name%// to include variables as long as the variable exists and has a value and there is no corresponding text token, although generally it is better and clearer to use the longer form //%Variable%Variable Name%//.
+===== See Also =====
+- [[:Text Fields]]
+- [[:Tokens]]
+- [[manual:Variables]]

Keyboard Maestro Wiki

User Tools

Site Tools

Differences

Page Tools