The map data type

Maps are collections of key-value pairs. Keys are identifiers, values can be of any type.

Literal syntax

{(key:value)*}

Parameter	Description
key (required)	The identifier of the associated value.
value (required)	Expression that evaluates to any data type.

Remarks

Values do not need to be of the same type. {foo:1, bar:"2", baz:3.00} is a valid map object literal.

Values of a map object are accessible not only using the map.GetAt() method, but via the dot operator as well as the index operator.

var dog = {'@#!%':1, foo:2};
trace dog.foo; // 2
trace dog.'@#!%'; // 1
trace dog["foo"]; // 2
trace dog["@#!%"]; // 1

Using the index operator and the map.GetAt() method, but not the dot operator, you can access values in a map object with dynamically built keys.

var dog = {'@#!%':1, foo:2};
...
var f = "fo";
trace dog[f + "o"]; // 2

Members

map.New() Creates a new empty map object.
map.ContainsKey() Determines whether a map has a value associated with a given key.
map.Count() Returns the number of key-value pairs in the map.
map.Clear() Deletes the content of a map object.
map.GetAt() Returns the value in a map that is associated with a specific key.
map.SetAt() Sets the value that is associated with a specific key in a map object.

Related links

list.SingleOrDefault()

Developer Documentation