dumpdictionaryquoted
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

- 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