dumpdictionaryquoted
DICTIONARY
,
DUMP

The dumpdictionaryquoted statement returns a carriage return separated array of dictionary keys and values (see Data Dictionaries).


Parameters

This statement has two parameters:

dictionary – name of the field or variable that contains the dictionary (must contain binary data).

dump – field or variable designated to receive the dumped dictionary.


Description

The dumpdictionaryquoted statement returns a carriage return separated array of dictionary keys and values. Each line contains a key/value pair. If the value is text it is quoted (for example Name="Jim"), but if it is numeric it is not quoted (for example Depth=3. The output of this function can be used directly in an execute statement as a series of assignments.

This statement is part of a suite that manipulates items in a key/value dictionary. This is not a language dictionary for spelling checks, but a dictionary that allows you to define words (names) and their values (definitions).

For example, this formula builds a dictionary and then dumps it.

local specifications,specDump
specifications=initializedictionary("Color","Blue","Shape","Oval","Depth",3)
dumpdictionaryquoted specifications,specDump

At the end of this procedure, the specDump variable will contain:

Color="Blue"
Shape="Oval"
Depth=3

Notice that the depth, which is numeric, is not quoted.

This same feature is available as a function for use in formulas, see dumpdictionaryquoted(.


See Also


History

VersionStatusNotes
10.0UpdatedCarried over from Panorama 6.0, but uses new internal dictionary format