ds_map_secure_load


Description

This function will load a previously saved ds_map from the given file. This file must have been previously created using the ds_map_secure_save() function, and, when loaded, the function will return the index of the ds_map that has been created from the loaded data. This ds_map index should be stored in a variable and used for all further function calls to this map. Note that if the DS map being loaded was saved with an array as one of the key values, this array will have been converted into a DS list on load.

IMPORTANT! One of the features of a secure saved file is that it is locked to the device that it was created on, so you cannot load a file saved on one device into a project running on another device.


Syntax:

ds_map_secure_load(filename);

Argument Description
filename The name of the file to load the map data from.


Returns:

Integer (DS map index)


Example:

p_map = ds_map_secure_load("p_data.dat");

The above code will load a securely saved ds_map and store its index value in a variable for future use.