Designing Games with Game Maker - YoYo Games

Lists
ds_queue_size(id) Returns the number of values stored in the queue.
ds_queue_empty(id) Returns whether the queue is empty. This is the same
as testing whether the size is 0.
ds_queue_enqueue(id,val) Enters the value in the queue.
ds_queue_dequeue(id) Returns the value that is longest in the queue and
removes it from the queue.
ds_queue_head(id) Returns the value at the head of the queue, that is, the
value that has been the longest in the queue. (It does not remove it from the
queue.)
ds_queue_tail(id) Returns the value at the tail of the queue, that is, the
value that has most recently been added to the queue. (It does not remove it
from the queue.)
ds_queue_write(id) Turns the data structure into a string and returns this
string. The string can then be used to e.g. save it to a file. This provides an
easy mechanism for saving data structures.
ds_queue_read(id,str) Reads the data structure from the given string (as
created by the previous call).
A list stores a collection of values in a particular order. You can add values at the end or insert
them somewhere in the middle of the list. You can address the values using an index. Also you
can sort the elements, either in ascending or descending order. Lists can be used in many
ways, for example to store changing collections of values. They are implemented using simple
arrays but, as this is done in compiled code it is a lot faster than using an array yourself. The
following functions are available:
ds_list_create() Creates a new list. The function returns an integer as an
id that must be used in all other functions to access the particular list.
ds_list_destroy(id) Destroys the list with the given id, freeing the
memory used. Don't forget to call this function when you are ready with the
structure.
ds_list_clear(id) Clears the list with the given id, removing all data from
it but not destroying it.
ds_list_copy(id,source) Copies the list source into the list with the