Finds and returns the first key, as stored by the computer, in the ds_map.


GML Code Example


Argument Description
id The id of the map to use.

Returns: Real or String


This function returns the first key stored in the ds_map. This is not the first key in the order you added them! Ds_maps are not stored in a linear form, for that use ds_lists, so all this does is find the first key as stored by the computer. This can be useful if your have to iterate through the ds_map looking for something, but should be avoided if possible as it can be slow.


GML Code Example

var size = ds_map_size(inventory) ;
 var first = ds_map_find_first(inventory);
 for (var i = 0; i < size; i++;)
    if first != "gold"
       first = ds_map_find_next(inventory, first);
    else break;

The above code creates some temporary variables and then gets the ds_map size and finds the first key as stored by the computer in the map. It then uses a for loop to iterate through the ds_map looking for the key value "gold". If it finds it, it breaks out the loop.

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