C API function to merge one subtree into another

[ksbhaskar]

Final Release Note

Description

Merging (deep copying) a subtree can perform better if implemented within the data management engine.

Draft Release Note

The ydb_merge_s() function provides a way to merge (deep copy) the nodes of one subtree into another. Any nodes with existing values are overwritten.

int ydb_merge_s(ydb_buffer_t *varname_dest,
    int subs_used_dest,
    ydb_buffer_t *subsarray_dest,
    ydb_buffer_t *varname_src,
    int subs_used_src,
    ydb_buffer_t *subsarray_src);

Previously, a merge required a loop in the application code using ydb_node_next_s(), ydb_get_s(), and ydb_set_s().