====MAPSET====

Sets a key/value pair on a [[map|map]].

===Parameters===

^Order^Name^Type^Desc^
|1|map|[[map|map]]|The map to be modified|
|2|key|[[const|const]]|The name of the key to set|
|3|value|[[const|const]]|The value to set|

===Returns===

Places an [[map|map]] on the stack.

===Description===

This function modifies //map// to include a new key-value pair.

If the key already exists, it will be overwritten with the new value.

If the key does not already exist, it will be added to the map.

For example, if you had the following map in your stack...

{ "name": "alpha",
       "colour": "orange",
       "style": "plain" }
        
 ...then the command **'colour' 'blue' MAPSET** will change the 'colour' element from //orange// to //blue//.

===See Also===

[[fMAPFILTER]]