initializedictionaryvalue(
KEY
,
VALUE
)

The initializedictionaryvalue( function builds a new dictionary and initializes it with one or more entries (see Data Dictionaries). This function is deprecated, we recommend using the initializedictionary( function instead.


Parameters

This function has two parameters:

key – name of an entry (this must be a text value). You can have more than one key parameter, as long as each key is accompanied by an associated value parameter.

value – value of an entry (this must be a text value).


Description

The initializedictionaryvalue( function creates a new collection of values (dictionary) and initializes it with one or more key/value pairs. This function is still included for legacy compatibility for older databases, but for new code we recommend using the initializedictionary( function.

Advanced Note: If you used dictionaries in a previous version of Panorama (6.0 or earlier), the internal format used for dictionary collections has changed. The older version supported only MacOSRoman encoded text (no Unicode text), and did not support non text values. The new format lifts both of these restrictions. The old format is still supported in “read-only” mode – the data in an old format dictionary can still be accessed, but will automatically be converted to the new format if any changes are made. The initializedictionaryvalue( function creates the dictionary using the old format, which is why it is deprecated. The old format allowed dictionary values to be directly appended to each other, which is no longer allowed in the new format. The recommended usage for this function was to use multiple instances of the function appended together, so to prevent breakage of older databases this function continues to use the old format.


See Also


History

VersionStatusNotes
10.0UpdatedCarried over from Panorama 6.0, however, use of this function is no longer recommended. Use the initializedictionary( function instead.