Dictionary class

Dictionary

The dictionary object

Parent class

Inherits from object

Constructors

• () - Create a new dictionary with non-argument.
  
• (params AnyType) - Create new dictionary with the specified key-value pairs.
  
• (array keys "keys arrayConstant", array values "values arrayConstant") - Create new dictionary with the specified keys and values.
  

Methods

• bool Add(string key "Add with specific key", object value "Add with specific value") - Adds the specified key and value to the dictionary. Return false if there is an item with the same key has already been added.
  
• bool Add(int key "Add with specific key", object value "Add with specific value") - Adds the specified key and value to the dictionary.
  
• Empty Add(Dictionary src "Source of keys and values to add") - Adds the all keys and values from src to current.
  
• Empty Clear() - Remove all keys and values from the dictionary.
  
• bool ContainsKey(string key "Check with specific key") - Determines whether the dictionary contains the specified key.
  
• bool ContainsKey(int key "Check with specific key") - Determines whether the dictionary contains the specified key.
  
• bool ContainsValue(object value "Add with specific value") - Determines whether the dictionary contains the specified value.
  
• Empty Foreach(Function function "A function that takes 2 parameters, the key and the value") - Run a function for each element.
  
• object this[] { get; }(string key "The key used to lookup the value.") - Get an item based on a key.
  
• object this[] { get; }(int key "The key used to lookup the value.") - Get an item based on a key.
  
• Empty Inc(string key "Increase the specific keys value") - Increase the value of a value for the given key by 1, creating the entry at 1 if doesnt exists.
  
• array KeysWhere(Function predicate "A function that takes 2 parameters, the key and the value, and return true/false") - Filters keys based on a predicate.
  
• object Remove(string key "Check with specific key") - Remove the value with the specified key from the dictionary.
  
• object Remove(int key "Remove with specific key") - Remove the value with the specified key from the dictionary.
  
• array Select(Function function "A function that takes 2 parameters, the key and the value, and return some value") - Run a function for each element and make array of return values.
  
• Empty this[] { set; }(string key "The key used to lookup the value.", object value "The value to set.") - Set an item based on a key and a value.
  
• Empty this[] { set; }(int key "The key used to lookup the value.", object value "The value to set.") - Set an item based on a key and a value.
  
• string ToString() - The string representation of the object.
  
• object TryGetValue(string key "Remove with specific key") - Gets the value associated with the specified key.
  
• object TryGetValue(int key "Remove with specific key") - Gets the value associated with the specified key.
  
• array ValuesWhere(Function predicate "A function that takes 2 parameters, the key and the value, and return true/false") - Filters values based on a predicate.
  

Properties

• int Count { get; } - Gets the number of key/value pairs contained in the dictionary.
  
• array Keys { get; } - Gets a list of keys.
  
• string ObjectTypeName { get; } - The name of the type of object.
  
• array SortedKeys { get; } - Gets a list of keys sorted by current collation.
  
• (From object) TypeInformation TypeInformation { get; } - Get information about this class.
  
• array Values { get; } - Gets a list of values.
  

Examples

Dictionary d;
print(d); // {}

Dictionary d = new Dictionary();
print(d);  // {}

Dictionary d = {"key1": 1, "key2": 2};
print(d);   // {"key1": 1, "key2": 2}

Dictionary d = {};             // Not work, will cause error.

Dictionary d1 = new Dictionary("key_01","value01");
print(d1);                                                                      // {"key_01": sdasd}
print(d1.Add("key_02",2222));
print(d1.Add(3,"hello3333"));
print(d1.Add("key_03",{"happy",48,{"funny","sad",88}}));
print(d1);                               //          {"3": hello3333, "key_01": value01, "key_02": 2222, "key_03": {happy,48,{funny,sad,88}}}
print(d1.ContainsKey("key_01"));                                                // true
print(d1.ContainsKey(3));                                                       // true
print(d1.ContainsKey("noexist"));                                               // false
print(d1.ContainsValue("value01"));                                             // true
print(d1.ContainsValue(2222));                                                  // true
print(d1.ContainsValue({"happy",48,{"funny","sad",88}}));                       // true
print(d1.get_Item("key_01"));                                                   // value01
print(d1.get_Item(3));                                                          // hello3333
print(d1.set_Item("key01",1111));     
print(d1.set_Item(3,{3333,"string333"}));
print(d1.TryGetValue("key_01"));                                                // value01
print(d1.TryGetValue(3));                                                       // {3333,"string333"}
print(d1);                              //     {"3": {3333,string333}, "key_01": value01, "key_02": 2222, "key_03": {happy,48,{funny,sad,88}}, "key01": 1111}
print(d1.Count);                                                                // 5
print(d1.Keys);                                                                 // {key_01,key_02,3,key_03,key01}
print(d1.Values);                                                               // {value01,2222,{3333,string333},{happy,48,{funny,sad,88}},1111}
print(d1.Remove("key_01"));                                                     // value01
print(d1.Remove(3));                                                            // {3333,string333}
print(d1);                                                                      // {"key_02": 2222, "key_03": {happy,48,{funny,sad,88}}, "key01": 1111}

Dictionary d = {
  "key01": "value01",
  5: "value05"
}; 
print(d["key01"]);       // another way to get the values of keys
print(d[5]);             // another way to get the values of keys

//Example for using d.Inc("key") to increase value of the key up to 1, if the key not exist, create the key with value 1
Dictionary d = {"key1": 1, "key2": 2};
d.Inc("key2");// key2 existed, so increate value of key2 to 1 (2->3)
print(d);//{"key1": 1, "key2": 3}
d.Inc("key3");// key3 not exist, so add key3 to d with value 1
print(d);//"key1": 1, "key2": 3, "key3": 1}

//Use KeysWhere/ValuesWhere to get list of keys/values meet filter
Dictionary d = {"key1":1,"key2":2,"key3":3,"key4":4};
//KeysWhere
d.KeysWhere(function(string key, number value ){if (value >= 3) return true;});// result: {key3,key4}
//ValuesWhere
d.ValuesWhere(function(string key, number value ){if (value >= 3) return true;});// result: {3,4}