herolab.XPath: Difference between revisions
Jump to navigation
Jump to search
mNo edit summary |
(Adding doc for optional delim parameter coming in 1.8) |
||
| Line 9: | Line 9: | ||
herolab.XPath(XPath) | herolab.XPath(XPath) | ||
herolab.XPath(XPath, id) | herolab.XPath(XPath, id) | ||
</source> | |||
==== Options Coming in 1.8 ==== | |||
<source lang="mtmacro" line> | |||
herolab.XPath(XPath, id, delim) | |||
herolab.XPath(XPath, id, "json") | |||
</source> | </source> | ||
| Line 14: | Line 19: | ||
{{param|XPath|The XPath expression to evaluate against the XML statblock.}} | {{param|XPath|The XPath expression to evaluate against the XML statblock.}} | ||
{{param|id|The id of the token. Defaults to the Current Token.}} | {{param|id|The id of the token. Defaults to the Current Token.}} | ||
{{param|delim|'''Coming in 1.8'''. Custom delimiter for the returned results. Defaults to {{code|", "}}. If equal to {{code|"json"}}, a [[JSON Array]] will be returned instead of a [[String List]].}} | |||
Returns the requested data. | Returns the requested data. | ||
| Line 28: | Line 34: | ||
Human Neutral Good 1 | Human Neutral Good 1 | ||
</source> | </source> | ||
==== Changes Coming in 1.8 ==== | |||
Sometimes the data desired from herolab contains commas or is otherwise incompatible with the [[String List]] format and default (comma) separator. In the following example, the list of spells retrieved includes one called "Delay Poison, Communal" - as we see in the default output, this element would be incompatible with the standard String List format. | |||
<source lang="mtmacro" line> | |||
[h: vXPath = "/document/public/character/spellsmemorized/spell[contains(@name,'De')]/@name"] | |||
Default: [r: herolab.XPath(vXPath)]<br /> | |||
Custom Delim: [r: herolab.XPath(vXPath, token.name, "|")]<br /> | |||
JSON: <pre>[r: json.indent(herolab.XPath(vXPath, currentToken(), "json"))]</pre> | |||
</source> | |||
Returns: | |||
<source lang="mtmacro"> | |||
Default: Delay Poison, Communal, Detect Magic, Detect Undead | |||
Custom Delim: Delay Poison, Communal|Detect Magic|Detect Undead | |||
JSON: | |||
[ | |||
"Delay Poison, Communal", | |||
"Detect Magic", | |||
"Detect Undead" | |||
] | |||
</source> | |||
When dealing with more complicated text elements with potential delimiter conflicts, it will usually be better to request the JSON output. | |||
|also= | |also= | ||
[[Hero Lab Integration|Hero Lab Integration]] | [[Hero Lab Integration|Hero Lab Integration]] | ||
|changes= | |||
* '''1.8''' - Added optional param for custom delimiter in returned results | |||
}} | }} | ||
[[Category:Hero Lab Function]] | [[Category:Hero Lab Function]] | ||
Revision as of 15:50, 21 September 2020
herolab.XPath() Function
Note: This function can only be used in a Trusted Macro
• Introduced in version 1.5.0
Returns data results based on the passed in XPath expression from the XML statblock. This is a reliable and easier way to get stat data from a character than using regular expression parsing of Text stat blocks.
Usage
herolab.XPath(XPath)
herolab.XPath(XPath, id)Options Coming in 1.8
herolab.XPath(XPath, id, delim)
herolab.XPath(XPath, id, "json")Parameters
XPath- The XPath expression to evaluate against the XML statblock.id- The id of the token. Defaults to the Current Token.delim- Coming in 1.8. Custom delimiter for the returned results. Defaults to", ". If equal to"json", a JSON Array will be returned instead of a String List.
Returns the requested data.
Example
Get various values from Hero Lab data (which is in XML).
When dealing with more complicated text elements with potential delimiter conflicts, it will usually be better to request the JSON output.
[race = herolab.XPath('/document/public/character/race/@name')]
[alignment = herolab.XPath('/document/public/character/alignment/@name')]
[improvedInit = herolab.XPath('boolean(/document/public/character/feats/feat[starts-with(@name,"Improved Initiative")])')]Returns:
Human Neutral Good 1Changes Coming in 1.8
Sometimes the data desired from herolab contains commas or is otherwise incompatible with the String List format and default (comma) separator. In the following example, the list of spells retrieved includes one called "Delay Poison, Communal" - as we see in the default output, this element would be incompatible with the standard String List format.
[h: vXPath = "/document/public/character/spellsmemorized/spell[contains(@name,'De')]/@name"]
Default: [r: herolab.XPath(vXPath)]<br />
Custom Delim: [r: herolab.XPath(vXPath, token.name, "|")]<br />
JSON: <pre>[r: json.indent(herolab.XPath(vXPath, currentToken(), "json"))]</pre>Returns:
Default: Delay Poison, Communal, Detect Magic, Detect Undead
Custom Delim: Delay Poison, Communal|Detect Magic|Detect Undead
JSON:
[
"Delay Poison, Communal",
"Detect Magic",
"Detect Undead"
]See Also
Version Changes
- 1.8 - Added optional param for custom delimiter in returned results