getVisibleTokenNames: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 8: Line 8:
* If the delimiter is not specified then a [[Macros:string list|string list]] is returned with the default value of ',' is used.
* If the delimiter is not specified then a [[Macros:string list|string list]] is returned with the default value of ',' is used.
* If the delimiter ''"json"'' then a [[Macros:json array|json array]] is returned.
* If the delimiter ''"json"'' then a [[Macros:json array|json array]] is returned.
* Otherwise a [[Macros:string list|string list]] is returned with the delimiter passed int.
* Otherwise a [[Macros:string list|string list]] is returned with the delimiter passed in.





Revision as of 12:34, 24 December 2008

Function getVisibleTokenNames

This function can only be called from a trusted macro


Introduced in MapTool 1.3b49

This function 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 = getVisibleTokens()]
[h: tokens = getVisibleTokens(delim)]


Examples

[h: tokens = getVisibleTokens()]


[h: tokens = getVisibleTokens("json")]