Dictionary

(Engine-Level Function)

Description: Creates a database-like storage structure that provides efficient addition, retrieval and removal of information linked to key values.

Keys can be any data type although integers and strings are recommended. Values can be any data type including another dictionary.

Returns: Dictionary
Usage: Script Only.
Function Groups: Dictionary,  Variable
Related to: MetaData | MakeDictionary | ArrayToDictionary | DictionaryCopy | DictionaryRemove | GetNextKey | GetKeyCount | HasMetaData | IsDictionary | ListKeys | RootValue
Format: Dictionary( [case] , [ root] );
Parameters:  
Case
Optional. A Boolean indicating whether the keys in the dictionary are to be case sensitive.
TRUE == Not Case Sensitive (default)
FALSE == Case Sensitive
Root   

Optional text value. Numeric values will be cast to text.
If not provided, the dictionary will have no root value. (default: Invalid)

In practice, root values are rarely used.

Example:

    X = Dictionary();
    X["A"] = 42;
    X["B"] = 86;
    X["C"] = 99;