getVisibleTokenNames: Difference between revisions
Jump to navigation
Jump to search
Verisimilar (talk | contribs) (Removed trusted.) |
m (Text replacement - "<source" to "<syntaxhighlight") |
||
| (7 intermediate revisions by 4 users not shown) | |||
| Line 3: | Line 3: | ||
|version=1.3b49 | |version=1.3b49 | ||
|description= | |description= | ||
Returns a [[Macros:string list|string list]] or [[JSON Array]] of [[Token:token]] names for the [[Token:token|token]]s that are ''visible'' to the player. The type of the value returned depends on the delimiter parameter. | |||
* If the delimiter is not specified then a [[Macros:string list|string list]] is returned with the default value of {{code|","}} is used. | * If the delimiter is not specified then a [[Macros:string list|string list]] is returned with the default value of {{code|","}} is used. | ||
* If the delimiter {{code|json}} then a [[ | * If the delimiter {{code|json}} then a [[JSON Array]] is returned. | ||
* Otherwise a [[Macros:string list|string list]] is returned with the delimiter passed in. | * Otherwise a [[Macros:string list|string list]] is returned with the delimiter passed in. | ||
| |||
<!-- The above 'nbsp' is needed so the DIV is closed --> | |||
|usage= | |usage= | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
[h: tokens = getVisibleTokenNames()] | [h: tokens = getVisibleTokenNames()] | ||
[h: tokens = getVisibleTokenNames(delim)] | [h: tokens = getVisibleTokenNames(delim)] | ||
</ | </syntaxhighlight> | ||
|examples= | |examples= | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
[h: tokens = getVisibleTokenNames()] | [h: tokens = getVisibleTokenNames()] | ||
</ | </syntaxhighlight> | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
[h: tokens = getVisibleTokenNames("json")] | [h: tokens = getVisibleTokenNames("json")] | ||
</ | </syntaxhighlight> | ||
|changes= | |changes= | ||
Latest revision as of 23:59, 14 March 2023
getVisibleTokenNames() Function
• Introduced in version 1.3b49
Returns a string list or JSON Array of Token:token names for the tokens that are visible to the player. The type of the value returned depends on the delimiter parameter.
- If the delimiter is not specified then a string list is returned with the default value of
","is used. - If the delimiter
jsonthen a JSON Array is returned. - Otherwise a string list is returned with the delimiter passed in.
Usage
[h: tokens = getVisibleTokenNames()]
[h: tokens = getVisibleTokenNames(delim)]Examples
[h: tokens = getVisibleTokenNames()][h: tokens = getVisibleTokenNames("json")]Version Changes
- 1.3b51 - No longer a trusted function.