script_execute

This function was originally designed for calling script assets in a dynamic way, but with the introduction of user-defined functions it can now be used in two ways:

• The first way is to support legacy scripts, where each script was a single function and the title of the script was also the name of the function. Used in this way, it will work as before and it will run a user created script asset, passing the given arguments into it. Note that it isn't actually calling the script in this case, but the script function of the same name within the script.
• The second way is to call a function from a script asset that contains multiple functions. In this case you would provide the function name and the arguments it requires rather than the script asset name. Note that this will only work for script functions and not for methods, as only script functions have a script ID assigned to them. For methods, use method_call().

NOTE While this function is designed primarily for legacy support, it is not deprecated as it still has its place in networking and remote procedure call situations. It is also worth noting that this function is slow, and using it a lot may adversely affect performance.

Syntax:

script_execute(scr, arg0, arg1, arg2, etc.);

Returns:

Any (Will depend on the return value from the script/function being called)

Example:

script_execute(choose(move_up, move_down, move_left, move_right), irandom(5));

The above example code will use script_execute to choose one of four user defined functions (in this case related to movement) and pass a random integer to it as the first argument.