getTokenMap: Difference between revisions
Jump to navigation
Jump to search
m (Conversion script moved page GetTokenMap to getTokenMap: Converting page titles to lowercase) |
m (Text replacement - "<source" to "<syntaxhighlight") |
||
| Line 7: | Line 7: | ||
|usage= | |usage= | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
getTokenMap(name/ID) | getTokenMap(name/ID) | ||
getTokenMap(name/ID, delim) | getTokenMap(name/ID, delim) | ||
| Line 18: | Line 18: | ||
|example= | |example= | ||
Suppose a token named "Dragon" is on two maps, "Grasslands" and "Arid". The command | Suppose a token named "Dragon" is on two maps, "Grasslands" and "Arid". The command | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
[r: getTokenMap("Dragon", "json")] | [r: getTokenMap("Dragon", "json")] | ||
</source> | </source> | ||
returns the JSON Array: | returns the JSON Array: | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
["Grasslands","Arid"] | ["Grasslands","Arid"] | ||
</source> | </source> | ||
Revision as of 20:31, 14 March 2023
getTokenMap() Function
Note: This function can only be used in a Trusted Macro
• Introduced in version 1.5.11
Gets the list of map(s) where a token resides. The list is returned either as a string list, or as a JSON Array.
Usage
<syntaxhighlight lang="mtmacro" line> getTokenMap(name/ID) getTokenMap(name/ID, delim) </source> Parameters Parameters
name/ID- Either the name of the token or the ID.delim- The delimiter used in the string list returned, defaults to",". If set tojson, then a JSON array is returned.
Example
Suppose a token named "Dragon" is on two maps, "Grasslands" and "Arid". The command
<syntaxhighlight lang="mtmacro" line> [r: getTokenMap("Dragon", "json")] </source> returns the JSON Array: <syntaxhighlight lang="mtmacro" line> ["Grasslands","Arid"]
</source>