ds_priority_delete_max

This function will return the value that has the highest priority in the queue and then remove the value (and priority) from the data structure. If more than one value has the same priority, then any one of them could be returned in any order, but all other values with the same priority will still be in the queue.

Syntax:

ds_priority_delete_max(id);

Returns:

Data type stored in the priority

Example:

if ai_move
    {
    script_execute(ds_priority_delete_max(ai_priority));
    }

The above code checks an instance variable and if it returns true it will execute a script indexed in the priority queue with the highest priority value and then remove that script from the queue.