, , )

---

The dictionaryfromarray( function builds a new dictionary and initializes it from a two dimensional text array (see Data Dictionaries and Text Arrays).

---

Parameters

This function has three parameters:

array – two dimensional text array containing the keys and values for the text array. The first column of the array contains the keys, the second column contains the values.

subseparator – the separator character (or characters) between the columns of the array. If this parameter is missing, the default subseparator is the tab character.

separator – the separator character (or characters) between the rows of the array. If this parameter is missing, the default separator is the carriage return character.

---

Description

The dictionaryfromarray( function creates a new collection of values (dictionary) and initializes it with one or more key/value pairs from a two dimensional text array. This example creates a new dictionary collection containing a US mailing address.

initializedictionary("Address:3987 Olive,City:Tustin,State:CA,Zip:92841",":",",")

In this example the new dictionary will contain four values: Address, City, State and Zip.

This example takes the output from the sips shell command and converts it into a dictionary.

dictionaryfromarray(arrayfilter(after(lftocr(
    shellscript("sips -g all "+imagefilepath)),cr()),cr(),
    {strip(before(import(),": "))+"¬"+strip(after(import(),": "))}))

The output from the sips shell command is normally something like this:

/Users/jacksmith/Pictures/Flowers.png
 pixelWidth: 1306
 pixelHeight: 916
 typeIdentifier: public.png
 format: png
 formatOptions: default
 dpiWidth: 144.000
 dpiHeight: 144.000
 samplesPerPixel: 4
 bitsPerSample: 8
 hasAlpha: yes
 space: RGB
 profile: sRGB IEC61966-2.1

The formula above converts this into a Panorama dictionary. You can then easily extract items from this dictionary with the getdictionaryvalue( function. (Note: You wouldn’t actually need to use this example, because Panorama already includes an imageinfo( function that performs this for you.)

---

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).
• classicdictionaryvalue( -- returns the value of an item in the dictionary, given its key (see Data Dictionaries). Unlike getdictionaryvalue(, this function does not treat keys as case sensitive.
• 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).
• 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.
• dumpdictionarysource( -- 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.
• 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.
• getstructurevalue( -- extracts a value from a structure of nested Data Dictionaries and/or Data Arrays.
• 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 zero 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.
• soundinfo( -- returns a dictionary that contains all of the properties of a sound.
• timerinfo( -- returns a dictionary that contains all of the properties of a timer.

---

History

Version	Status	Notes
10.0	New	New in this version.