mapSetSubmapAt - method of the PmMap object

Description:

Returns an embedded Submap. If the embedded map does not exist then it is created.
All items defined in the sSubmap parameter in the KeyVal format are added into the embedded Submap.

Syntax:

PmMap mapSetSubmapAt(String sProp, String sOper, String sSubmap)

Parameters:

sProp	(String) Property name.
sOper	(String) Specifies the type of the operation - this is not used so far. It is necessary to enter "" (empty string).
sSubmap	(String) The text string containing definitions of property names and values. The text string syntax is: "Name1:Value1;Name2: ... ;". This is a text in the KeyVal format. Empty string ("") means that no new items are added into the Submapy.

Return value:

Returns object of the PmMap type (embedded Submap).

Note:

This method is also functional in Web panels.

The property value can also be read directly (value = mMap.property). This method can be used for more general approach - for example the property name can be stored in another variable.

Example:

JavaScriptSelect and copy to clipboard



var mMap = Pm.CreatePmMap();

var mMap2 = mMap.mapSetSubmapAt("pars", "", "title0:ABC;value0:1;title1:XYZ;value1:2;");


Pm.Debug("mapSetSubmapAt.title0=" + mMap2.mapGetValueAt("title0"));

Pm.Debug("mapSetSubmapAt.value0=" + mMap2.mapGetValueAt("value0"));