Dictionary

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.

dictionary_with_three_defs_2.gif

 

Returns:                    Dictionary

Usage:                       Script

Format:                      Dictionary( [case sensitive] , [ root] );

Parameters:             Case sensitive     { numeric }  { optional }  { default: 1 }
          A Boolean indicating whether the keys in the dictionary are to be case sensitive.  Once the dictionary has been created and the first key assigned to it, this attribute cannot be changed.  If not provided, the dictionary will not be case sensitive. (default: 1)

                                                0 == Case Sensitive

                                                1 == Not Case Sensitive

                                    Root     { varies }  { optional }  { default: invalid }
          Any value that is to be stored as the root of the dictionary.  If not provided, the dictionary will have no root value. (default: Invalid)

                                   

Example:

X = Dictionary(0, 5);

X[“A”] = 42;

X[“B”] = 86;

X[“C”] = 99;         

See Also:

MetaData, DictionaryCopy, DictionaryRemove, GetNextKey, GetKeyCount, HasMetaData, IsDictionary, ListKeys, RootValue