getVisibleTokenNames: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
(Applied Template:MacroFunction)
m (Text replacement - "<source" to "<syntaxhighlight")
 
(10 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{MacroFunction
{{MacroFunction
|name=getVisibleTokenNames
|name=getVisibleTokenNames
|trusted=true
|version=1.3b49
|version=1.3b49
|description=
|description=
This function returns a [[Macros:string list|string list]] or [[Macros:json array|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 [[Macros:json array|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;
<!-- 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=
{{change|1.3b51|No longer a trusted function.}}
 
}}
}}
[[Category:Token Find Function]]
[[Category:Find Function]]
[[Category:Token Function]]

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.