This function will remove the given stack 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 stack to prevent memory leaks that can slow down and crash your game.
NOTE You should always set the variable that held the data structure reference to -1 after calling this function, since the reference will no longer be valid.
ds_stack_destroy(id);
| Argument | Type | Description |
|---|---|---|
| id | DS Stack | The stack data structure to remove. |
N/A
if (lives == 0)
{
ds_stack_destroy(AI_stack);
AI_stack = -1;
room_goto(rm_Menu);
}
The above code will check the value of the built in global variable lives and if it is 0, it destroys the DS stack referenced in the variable AI_stack and then changes rooms.