RPTools

Personal tools
From MapToolDoc

getStrProp

Contents

getStrProp() Function

• Introduced in version 1.3b42

Returns the value associated with a key from the specified string property list.

Usage 

  1. getStrProp(propList, key)
  2. getStrProp(propList, key, default)
  3. getStrProp(propList, key, default, delim)

Parameters

  • proplist - String property list to extract data from.
  • key - Key within string to extract.
  • default - Value returned if the key is not found.
  • delim - Delimiter between fields (default is ";").

Example

To get the name from a weapon string property list 

  1. [h: weapon = "name=longsword; damage=1d8; maxdamage=8"]
  2. Name of Weapon: [r: getStrProp(weapon, "name")]

Returns Name of Weapon: longsword.

To get the minimum damage from a weapon string property list with a default value should the key not exist 

  1. [h: weapon = "name=longsword; damage=1d8; maxdamage=8"]
  2. Minimum damage of Weapon: [r: getStrProp(weapon, "mindamage", 1)]

Returns Minimum damage of Weapon: 1.

To get the damage from a weapon string property list where the field delimiter is a colon. The default is 1d3 (note that a default value must be provided in order to specify the delimiter). 

  1. [h: weapon = "name=longsword: damage=1d8: maxdamage=8"]
  2. Damage of Weapon: [r: getStrProp(weapon, "damage", "1d3", ":")]

Returns Damage of Weapon: 1d8.


Version Changes

  • 1.3b43 - Added the optional error parameter.
Retrieved from "http://www.lmwcs.com/rptools/wiki/getStrProp"