getTableEntry: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
No edit summary
m (Added "picked" return element in the example.)
 
(4 intermediate revisions by 2 users not shown)
Line 9: Line 9:


|usage=
|usage=
<source lang="mtmacro">
<syntaxhighlight lang="mtmacro">
getTableEntry(table, roll)
getTableEntry(table, roll)
</source>
</syntaxhighlight>
'''Parameters'''
'''Parameters'''
{{param|table|Name of table as a string.}}
{{param|table|Name of table as a string.}}
Line 18: Line 18:
|example=
|example=
Get the entry from table "Critters" matching a roll of 4.
Get the entry from table "Critters" matching a roll of 4.
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
[r: getTableEntry("Critters", 4)]
[r: getTableEntry("Critters", 4)]
</source>
</syntaxhighlight>
Returns:
Returns:
<source lang="javascript">
<syntaxhighlight lang="javascript">
{"min":3, "max":5, "value": "duck", "assetid":""}
{"min":3, "max":5, "value": "duck", "picked":false, "assetid":""}
</source>
</syntaxhighlight>


|also=
|also=

Latest revision as of 04:04, 25 October 2024

getTableEntry() Function

 Note: This function can only be used in a Trusted Macro

Introduced in version 1.5.4
Retrieves the raw table data for the specified entry as a JSON object. Returns an empty string if the entry doesn't exist. If no image is associated with the entry the assetid will be an empty string.

Usage

getTableEntry(table, roll)

Parameters

  • table - Name of table as a string.
  • roll - The entry to retrieve as if a roll of that value had been made.

Example

Get the entry from table "Critters" matching a roll of 4.
[r: getTableEntry("Critters", 4)]

Returns:

{"min":3, "max":5, "value": "duck", "picked":false, "assetid":""}

See Also