Dictionary type.
Dictionary type. Associative container which contains values referenced by unique keys. Dictionary are composed of pairs of keys (which must be unique) and values. You can define a dictionary by placing a comma separated list of [code]key: value[/code] pairs in curly braces [code]{}[/code]. Erasing elements while iterating over them [b]is not supported[/b]. Creating a dictionary: [codeblock] var my_dir = {} # Creates an empty dictionary. var points_dir = {"White": 50, "Yellow": 75, "Orange": 100} var my_dir = { key1: value1, key2: value2, key3: value3, } [/codeblock] You can access values of a dictionary by referencing appropriate key in above example [code]points_dir["White"][/code] would return value of 50. [codeblock] export(String, "White", "Yellow", "Orange") var my_color var points_dir = {"White": 50, "Yellow": 75, "Orange": 100}

func _ready(): var points = points_dir[my_color] [/codeblock] In the above code [code]points[/code] will be assigned the value that is paired with the appropriate color selected in [code]my_color[/code]. Dictionaries can contain more complex data: [codeblock] my_dir = {"First Array": [1, 2, 3, 4]} # Assigns an Array to a String key. [/codeblock] To add a key to an existing dictionary, access it like an existing key and assign to it: [codeblock] var points_dir = {"White": 50, "Yellow": 75, "Orange": 100} var points_dir["Blue"] = 150 # Add "Blue" as a key and assign 150 as its value. [/codeblock] Finally, dictionaries can contain different types of keys and values in the same dictionary: [codeblock] var my_dir = {"String Key": 5, 4: [1, 2, 3], 7: "Hello"} # This is a valid dictionary. [/codeblock] [b]Note:[/b] Unlike [Array]s you can't compare dictionaries directly: [codeblock] array1 = [1, 2, 3] array2 = [1, 2, 3]

func compare_arrays(): print(array1 == array2) # Will print true.

dir1 = {"a": 1, "b": 2, "c": 3} dir2 = {"a": 1, "b": 2, "c": 3}

func compare_dictionaries(): print(dir1 == dir2) # Will NOT print true. [/codeblock] You need to first calculate the dictionary's hash with [method hash] before you can compare them: [codeblock] dir1 = {"a": 1, "b": 2, "c": 3} dir2 = {"a": 1, "b": 2, "c": 3}

func compare_dictionaries(): print(dir1.hash() == dir2.hash()) # Will print true. [/codeblock]
https://docs.godotengine.org/en/latest/getting_started/scripting/gdscript/gdscript_basics.html#dictionary
Clear the dictionary, removing all key/value pairs.
Creates a copy of the dictionary, and returns it.
Returns [code]true[/code] if the dictionary is empty.
Erase a dictionary key/value pair by key. Returns [code]true[/code] if the given key was present in the dictionary, [code]false[/code] otherwise. Does not erase elements while iterating over the dictionary.
Returns the current value for the specified key in the [Dictionary]. If the key does not exist, the method returns the value of the optional default argument, or [code]null[/code] if it is omitted.
Returns [code]true[/code] if the dictionary has a given key.
Returns [code]true[/code] if the dictionary has all of the keys in the given array.
Returns a hashed integer value representing the dictionary contents. This can be used to compare dictionaries by value: [codeblock] var dict1 = {0: 10} var dict2 = {0: 10} # The line below prints `true`, whereas it would have printed `false` if both variables were compared directly. print(dict1.hash() == dict2.hash()) [/codeblock]
Returns the list of keys in the [Dictionary].
Returns the size of the dictionary (in pairs).
Returns the list of values in the [Dictionary].