With this function you can recreate a saved DS queue (one that has previously been written as a string using ds_queue_write()). You must first create a new DS queue to read the string into, and if the DS queue already exists and has information stored in it, then this will be cleared before reading. This function is of vital importance when creating save/load mechanisms for your game.
Note that if the specified DS string was written by the GameMaker: Studio 1.2.x runtime (or older), you should specify the optional argument "legacy", setting it to true as the string format changed after that.
ds_queue_read(id, str [, legacy]);
| Argument | Type | Description |
|---|---|---|
| id | DS Queue | The id of the data structure to read into. |
| str | String | The string to read from. |
| legacy | Boolean | OPTIONAL Can be either true or false or omitted completely. |
N/A
queue = ds_queue_create();
ini_open("save.ini");
var str = ini_read_string("Queues", "0", "");
if (str != "")
{
ds_queue_read(queue, str);
}
ini_close();
The above code creates a queue and stores the index in the variable "queue". It then opens an ini file and reads a string from that, checking to make sure that the string is not returned as empty first. This string is then read into the newly created DS queue.