ds_stack_read

Reads a stack data structure from a string.

Syntax:

GML Code Example

ds_stack_read(id, str [, legacy] );


Argument Description
id The id of the data structure to read into.
str The string to read from.
legacy (optional) Can be either true or false or omitted completely.


Returns: N/A


Description

With this function you can recreate a saved ds_stack (one that has previously been written as a string using ds_stack_write). You must first create a new ds_stack to read the string into, and if the ds_stack 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 data structure was created with previous versions of GameMaker you should add the optional argument "legacy", setting it to true as the string format has changed with this version.


Example:

GML Code Example

stack = ds_stack_create();
 ini_open("save.ini");
 var str = ini_read_string("Stacks", "0", "");
 if str != ""
    {
    ds_stack_read(stack, str);
    }
 ini_close();

The above code creates a stack and stores the index in the variable "stack". 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_stack.


Back: Stacks



No Examples Submitted

Does this page need better examples? Be the first to Submit

No Edits Suggested

Is this page unclear or not descriptive enough? Suggest an edit to the page and with enough upvotes your changes will be made.

No Questions Have Been Ask

Do you have a question about this page? Ask it Here