Click above to get retro games delivered to your door ever month!

##############################################################################
###+-------+##################################################################
#+-| _QUIT |-----------------------------------------------+##################
#| +-------+ The _QUIT command terminates your program and |##################
#|           returns to DOS without executing the runtime  |##################
#|           call back table or closing open files         |##################
#+---------------------------------------------------------+##################
##############################################################################
##############################################################################
#+--| Syntax |--------------+#################################################
#|     _QUIT <Uint-exp>     |#################################################
#+--------------------------+#################################################
##############################################################################
##############################################################################
########+---| Description |-----------------------------------------+#########
########| _QUIT returns the <Uint-exp> to DOS as an exit code.  The |#########
########| <Uint-exp> can be queried in a batch file using the DOS   |#########
########| ERRORLEVEL command.                                       |#########
########+-----------------------------------------------------------+#########
##############################################################################
##############################################################################
###########+---| Design |-----------------------------------------+###########
###########| When the FORCE runtime code terminates, it calls a   |###########
###########| "call back" procedure that closes all open files,    |###########
###########| etc..  The QUIT command or the ENDPRO keyword        |###########
###########| terminating the force_main procedure, each exit a    |###########
###########| program through the call back.                       |###########
###########| ---------------------------------------------------- |###########
###########| The _QUIT command does NOT go through the call back  |###########
###########| procedure.  It immediately exits to DOS.  Do not use |###########
###########| _QUIT if there are any installed interrupt handlers  |###########
###########| or your program uses the tsr() function.             |###########
###########+------------------------------------------------------+###########
##############################################################################
##############################################################################
#########+--| Example 1 |-------------------------------------------+#########
#########| *    Tell DOS of error and leave without going           |#########
#########| *    through the runtime call back system.               |#########
#########|                                                          |#########
#########| _QUIT 10                                                 |#########
#########+----------------------------------------------------------+#########
##############################################################################
##############################################################################
#########+--| Example 2 |-------------------------------------------+#########
#########| *    Return to DOS with an error code that a             |#########
#########| *    batch file can query using ERRORLEVEL.              |#########
#########| *    A batch file could read:                            |#########
#########| *        xyz                                             |#########
#########| *        IF ERRORLEVEL 1 GOTO endbatch                   |#########
#########|                                                          |#########
#########| PROCEDURE return_errorlevel                              |#########
#########|     _QUIT errorlevel[ z ]                                |#########
#########| ENDPRO                                                   |#########
#########|                                                          |#########
#########| PROCEDURE force_main                                     |#########
#########|     ON ERROR DO return_errorlevel                        |#########
#########|     {...}                                                |#########
#########| ENDPRO                                                   |#########
#########+----------------------------------------------------------+#########
##############################################################################