,

---

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

• array( -- extracts a single data item from a text array or a data array (see Text Arrays and Data Arrays).
• arraydeduplicate( -- removes duplicate elements from a text array (see Text Arrays).
• arrayelement( -- converts between character positions and array element numbers in a text array.
• arraymultisort( -- sorts a two-dimensional array on the key of one or more of its columns.
• arraynumericsort( -- sorts a text array in numeric order (see Text Arrays).
• arrayrange( -- extracts a series of data items from a text array or a data array (see Text Arrays and Data Arrays).
• arrayreverse( -- reverses the order of the elements in a text array or a data array (see Text Arrays and Data Arrays).
• arraysearch( -- searches a text array or a data array (see Text Arrays and Data Arrays) to see if it contains a specific value.
• extract( -- extracts a single data item from a text array, and can also be used to count the number of items in the array.
• Text Arrays -- A numbered collection of text values.

---

History

Version	Status	Notes
10.0	Updated	Carried over from Panorama 6.0, but uses new internal dictionary format