dumpdictionarysource( function

dumpdictionarysource(

DICTIONARY

)

The dumpdictionarysource( function returns a carriage return separated array of dictionary keys and values (see Data Dictionaries). The keys and values are quoted so that they could be used to re-assemble the dictionary with the initializedictionary( function.

Parameters

This function has one parameter:

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

Description

This function 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 to create an initializedictionary( function.

This function 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 back out in the same format.

dumpdictionarysource(initializedictionary("Color","Blue","Shape","Oval","Depth",3))

The result of this formula will be:

"Color","Blue",
"Shape","Oval",
"Depth",3

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

Other functions that are related to this function are:

dictionaryassignmentscode( -- The dictionaryassignmentscode( function returns code that can be used to take the values in a dictionary (see Data Dictionaries) and assign them to fields or variables based on the dictionary keys.
dumpdictionary( -- The dumpdictionary( function returns a carriage return separated array of dictionary keys and values (see Data Dictionaries).
dumpdictionaryquoted( -- The dumpdictionaryquoted( function returns a carriage return separated array of dictionary keys and values (see Data Dictionaries). The text values are quoted.

See Also

appenddictionaryvalue -- appends a value to an item in a dictionary (see Data Dictionaries).
changedictionaryname -- changes the name (key) of an item in a dictionary (see Data Dictionaries).
changedictionaryvalues( -- changes one or more values in a dictionary (see Data Dictionaries).
clearglobaldictionaryvalues -- clears (removes) all the keys and values from the specified global dictionary.
copypartialdictionary -- builds a new dictionary and initializes it with values from an existing dictionary (see Data Dictionaries).
copypartialdictionary( -- partially copies a dictionary (see Data Dictionaries).
Data Dictionaries -- Overview of Panorama's key/value data dictionaries.
deletedictionaryvalue -- deletes a key/value pair from a dictionary (see Data Dictionaries).
deletedictionaryvalue( -- deletes one or more key/value pairs from a dictionary (see Data Dictionaries).
deleteglobaldictionaryvalues -- deletes one or more global dictionary values.
dictionaryassignmentscode( -- returns code that can be used to take the values in a dictionary (see Data Dictionaries) and assign them to fields or variables based on the dictionary keys.
dictionarydifference -- builds an array that lists keys of dictionary values that are different between two dictionaries (see Data Dictionaries).
dictionaryfromarray( -- builds a new dictionary and initializes it from a two dimensional text array (see Data Dictionaries and Text Arrays).
dictionaryfromvariables( -- builds a new dictionary and initializes it from a list of variables (carriage return delimited).
dictionaryvalueexists -- returns true or false depending on whether or not a key/value pair exists in a dictionary (see Data Dictionaries).
dictionaryvalueexists( -- returns true or false depending on whether or not a key/value pair exists in a dictionary (see Data Dictionaries).
dumpdictionary -- returns a carriage return separated array of dictionary keys and values (see Data Dictionaries).
dumpdictionary( -- returns a carriage return separated array of dictionary keys and values (see Data Dictionaries).
dumpdictionaryquoted -- returns a carriage return separated array of dictionary keys and values (see Data Dictionaries).
dumpdictionaryquoted( -- returns a carriage return separated array of dictionary keys and values (see Data Dictionaries). The text values are quoted.
getdictionarykey -- returns the key of an item in the dictionary, given its value. This is essentially the opposite of the getdictionaryvalue( function (see Data Dictionaries).
getdictionarykey( -- returns the key of an item in the dictionary, given its value). This is essentially the opposite of the getdictionaryvalue( function (see Data Dictionaries).
getdictionaryvalue -- returns the value of an item in the dictionary, given its key (see Data Dictionaries).
getdictionaryvalue( -- returns the value of an item in the dictionary, given its key (see Data Dictionaries).
getglobaldictionary( -- converts a global dictionary into a regular dictionary.
Global Dictionaries -- alertnate high performance method to store multiple data items, much faster than regular data dictionaries.
globaldictionarybuild -- builds a global dictionary by scanning a database.
globaldictionarykeys( -- returns a cr()-separated array containing the keys in a global dictionary, or the names of all global dictionaries.
globaldictionaryvalue( -- returns the value of an item in a global dictionary, given its key (see Global Dictionaries).
info("timerinfo") -- returns a dictionary that contains all of the properties of the currently running timer.
initializedictionary -- builds a new dictionary and initializes it with one or more key/value entries (see Data Dictionaries).
initializedictionary( -- builds a new dictionary and initializes it with one or more key/value entries (see Data Dictionaries).
initializedictionaryvalue( -- 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.
listdictionarykeys( -- returns a list of the keys in a dictionary collection.
listdictionarynames -- returns a list of the names (keys) in a dictionary (see Data Dictionaries).
mergedictionaries -- merges the contents of two or more dictionaries (see Data Dictionaries).
mergedictionaries( -- merges the contents of two or more dictionaries (see Data Dictionaries).
renamedictionarykey( -- changes the key (name) of one or more values in a dictionary (see Data Dictionaries).
setdictionaryvalue -- changes a value in a dictionary (see Data Dictionaries).
setglobaldictionaryvalues -- sets one or more key/value pairs in a global dictionary.
setlocalsfromdictionary -- converts a dictionary into a collection of local variables. The names and values of the local variables will be derived from the dictionary contents.
timerinfo( -- returns a dictionary that contains all of the properties of a timer.

History

Version	Status	Notes
10.2	New	New in this version.