mdstring

This topic is about the MDSTRING data type.

Value syntax

{dic1={key1=value1}{key2=value2}}{dic2={key3=value3}}

Description

Dictionary of dictionaries (2 levels) field. It can be used to describe complex structures.

Special value assignment

The MDSTRING field supports a special value assignment to allow adding a new dictionary with a single entry, or replacing an existing entry in an already existing dictionary.

To use special value assignment

• Use the following syntax.

  "+dictionaryName,entryName=entryValue"

This approach is alternative to using the setValue attribute.

Full example of standard assignment and special assignment syntax.

<!-- standard assignment -->

<!-- ................... -->

<!-- overriding the content of the whole dictionary-->

<setfield name="aDic.value" value="{dic1={entry1=value1}{entry2=value2}}{dic2={entry3=value3}{entry4=value4}{entry5=value5}}" />

<!-- special assignment -->

<!-- ................... -->

<!-- adding a new dictionary with a single entry-->

<setfield name="aDic.value" value="+dic3,entry6=value6" />

<!-- adding a new entry to existing dictionary -->

<setfield name="aDic.value" value="+dic3,entry7=value7" />

<!-- replacing and existing entry in an existing dictionary -->

<setfield name="aDic.value" value="+dic1,entry1=value10" />

Attributes

These are the attributes for MDSTRING.