merge.md

jsoncons::json::merge

void merge(const json& source); // (1)
void merge(json&& source); // (2)
void merge(object_iterator hint, const json& source); // (3)
void merge(object_iterator hint, json&& source); // (4)

Copies the key-value pairs in source json object into json object. If there is a member in source json object with key equivalent to the key of a member in json object, then that member is not copied.

Parameters

source

`json` object value

Return value

None

Exceptions

Throws std::runtime_error if source or *this are not json objects.

Examples

Merge json

json j = json::parse(R"(
{
    "a" : 1,
    "b" : 2
}
)");

const json source = json::parse(R"(
{
    "a" : 2,
    "c" : 3
}
)");

j1.merge(source);

std::cout << j << endl;

Output:

{"a":1,"b":2,"c":3}