room_goto_previous

With this function you can make your game go to the previous one as listed in the Room Manager at the time the game was compiled. If this room does not exist, an error will be thrown and the game will be forced to close. Note that the room will not change until the end of the event where the function was called, so any code after this has been called will still run if in the same event. This function will also trigger the Room End event.

NOTE You will not be able to create new instances of objects in the same event after this function is called. There is one exception: if the object you're creating an instance of is already marked persistent, or its persistent variable is set to true in the variable struct passed into the instance_create_*() function, it will be created.

In the latter case (making the new instance persistent through the variable struct), the Variable Definitions for that instance will not be executed.

 

Syntax:

room_goto_previous();

 

Returns:

N/A

 

Example:

if (room_exists(room_previous(room)))
{
    room_goto_previous();
}

The above code will check to see if there is another room before the current one and if so it will go to that room.