Create Stack


Description

This action will create a new stack data-structure and return the index value so you can later access the stack through the other Data Structure actions. The stack index will be returned to the Target Variable that you supply, which can have been created earlier using either Assign Variable or Declare Temp, or you can flag the "Temp" checkbox to name and create a temporary local variable to store the value until the end of the script or event. A newly created stack data structure is considered "empty", ie: it contains no entries. Note that you can create additional DS stacks by clicking the plus icon beside the action, and selecting another variable to hold the stack ID.

Important! Creating any data structure uses up memory on the target platform, and as such all data structures should be free when no longer needed using the action Free Data Structure otherwise you get a memory leak which can impair your games performance or even cause it to crash. This is particularly relevant when using temporary local variables to store data structure indices, as these variables are removed at the end of the code or event, but that does not mean the data structure is removed too! The data structure will still exist, only you will have no way to reference it, so either use an instance variable and free the structure at a later time, or free the structure before the end of the event or script if its index is stored in a temporary variable.


Action Syntax:

Create Stack Syntax


Arguments:

Argument Description
Target The target variable to store the stack index in


Example:

Create Stack Example
The above action block code creates an instance variable and a new stack data structure. The index of the stack is stored in the new variable, and then a loop is performed which creates 1o instances and pushes their unique ID values onto the stack.