Differences

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

--- token:Variable [2016/05/24 02:55] – peternlewis
+++ token:Variable [2023/09/13 03:50] (current) – peternlewis
@@ Line 1: / Line 1: @@
-{{:token:variable-icon.png |}}
+===== Variable Token =====
-The //%Variable%//`<VariableName>`% token allows you to include a [[:Variables|variable]] in a [[:Text Fields |token text field]], where `<VariableName>` is the name of the variable.
+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.
 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%//.
@@ Line 13: / Line 15: @@
 - [[:Text Fields]]
 - [[:Tokens]]
-- [[:Variables]]
+- [[manual:Variables]]