sys_exit(STRING*)
Ends the application and shuts down the engine
at the end of the frame. The given string is printed
into
the
WINEND
exit window (if any).
Parameters
STRING* - pointer to a STRING* or char* to be printed in the exit window.
Remarks
- The engine closes one frame after the function call.
The call does not terminate the current function, so place a return() after it if desired.
- Immediately
before shutting down the on_exit event is triggered.
-
A7.84 If the string begins with a number, the application returns with the error code given with this number. Otherwise it returns with error code 0. This way lite-C applications can control batch files.
Example:
function on_x_event() { sys_exit("123"); } // [x] exits the application with exit code 123
See also:
on_exit, WINDOW
► latest
version online