ds_priority_delete_min

This function will return the value that has the lowest 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_min(id);

Returns:

Data type stored in the priority

Example:

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

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