ds_priority_destroy

Destroys a given priority queue and removes it from memory.

Syntax:

ds_priority_destroy(id);

Returns: N/A

Description

This function will remove the given priority queue 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_priority queue to prevent memory leaks that can slow down and crash your game.

Example:

if lives = 0
   {
   ds_priority_destroy(AI_queue);
   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_queue indexed in the variable "AI_queue" and then changes rooms.