ds_exists

Check to see if a data structure of a given type exists.

Syntax:

GML Code Example

ds_exists(ind, type);


Argument Description
ind The variable index to check for the data structure
type The type of data structure to check for (see the list of constants below)


Returns: Boolean


Description

With this function you can check to see if a data structure of the given type exists. You supply the "index" value (as held in a variable) and the ds "type", which can be any of the constants listed below, and the function will return true if the data structure exists and false otherwise.

Constant Description
ds_type_map A map data structure
ds_type_list A list data structure
ds_type_stack A stack data structure
ds_type_grid A grid data structure
ds_type_queue A queue data structure
ds_type_priority A priority data structure


Example:

GML Code Example

if !ds_exists(ai_grid, ds_type_grid)
    {
    ai_grid = ds_grid_create(room_width / 32, room_height / 32);
    }
 

The above code checks the (previously initialised) variable "ai_grid" to see if it indexes a ds_grid type data structure, and if it does not then it creates one and stores its index in the variable.





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