getVisibleTokenNames: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
mNo edit summary
m (Text replacement - "<source" to "<syntaxhighlight")
 
(5 intermediate revisions by 3 users not shown)
Line 3: Line 3:
|version=1.3b49
|version=1.3b49
|description=
|description=
This function 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.
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 [[JSON Array]] is returned.
* 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.
&nbsp;
&nbsp;
 
<!-- The above 'nbsp' is needed so the DIV is closed -->
|usage=
|usage=
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
[h: tokens = getVisibleTokenNames()]
[h: tokens = getVisibleTokenNames()]
[h: tokens = getVisibleTokenNames(delim)]
[h: tokens = getVisibleTokenNames(delim)]
</source>
</syntaxhighlight>


|examples=
|examples=
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
[h: tokens = getVisibleTokenNames()]
[h: tokens = getVisibleTokenNames()]
</source>
</syntaxhighlight>


<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
[h: tokens = getVisibleTokenNames("json")]
[h: tokens = getVisibleTokenNames("json")]
</source>
</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 json then 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.