This function will remove the given list data-structure from memory, freeing up the resources it was using and removing all values that it contained. This function should always be used when you are finished using the ds_list to prevent memory leaks that can slow down and crash your game.IMPORTANT! When you create a data structure, the index value to identify it is an integer value starting at 0. This means that data structures of different types can have the same index value, so if in doubt you should be using the ds_exists function before accessing them. Also note that indices are re-used, so a destroyed data structure index value may be used by a newly created one afterwards so we recomend always setting the variable that held the DS index to -1 after destroying.
|id||The id of the data structure to remove.|
if lives = 0
AI_list = -1;
The above code will check the value of the built in global variable "lives" and if it is 0, it destroys the ds_list indexed in the variable "AI_list" and then changes rooms.