From MapToolDoc
Jump to: navigation, search

json.merge() Function

Introduced in version 1.3b53

Merges multiple JSON Arrays or JSON Objects.

For JSON Arrays the value returned is that of all the JSON Arrays concatenated together.

For JSON Objects the value returned is a JSON Object with all of the keys from all of the JSON Objects set, if any key is specified in more than one JSON Object then the value for the last specified JSON Object is used.


  1. json.merge(array, array, ...)
  1. json.merge(object, object, ...)



Merge three JSON Arrays:

  1. [r: json.merge("[1,2]", "[3,4]", "[1,2]")]

Returns: [1,2,3,4,1,2]

Merge two JSON Objects with no matching keys:

  1. [r: json.merge("{a:1, b:2}", "{c:10, d:7}")]

Returns: {"a":1,"b":2,"c":10,"d":7}

Merge three JSON Objects with a matching key, a:

  1. [r: json.merge("{a:1, b:2}", "{c:10, d:7}", "{a:11, z:7}")]

Returns: {"a":11,"b":2,"c":10,"d":7,"z":7}

See Also

json.union(), json.intersection()

Version Changes

  • 1.3b54 - Fixed bug which allows json.merge() to work correctly with JSON Objects.