The "ds_list_replace_map" Function

Syntax

ds_list_replace_map(id, oldlist, newlist);

Argument	Type	Description
id	ds_list	The data structure to add new data to
oldmap	ds_map	The data structure to be replaced
newmap	ds_map	The data structure to be added

Description

Replaces a ds_map previously added to a ds_list with the contents of a new ds_map.

warning

Because data structures are referenced by numerical values, this script may not behave as you expect! If a numerical entry in the parent ds_list happens to match the value of a child ds_map, there is no guarantee which value will be replaced!

Intended only for use with JSON functions. Normally, adding one data structure to another simply stores a reference to the data structure, therefore this function is necessary to flag the list value as a data structure itself so its contents are written to the JSON file.

Example

my_list = ds_list_create();

my_map = ds_map_create();

my_new_map = ds_map_create();

ds_list_add_map(my_list, my_map);

ds_list_replace_map(my_list, my_map, my_new_map);