Retro video games delivered to your door every month!
Click above to get retro games delivered to your door ever month!
X-Hacker.org- FORCE Data Base Compiler - ############################################################################## http://www.X-Hacker.org [<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
##############################################################################
###+-------+##################################################################
#+-| _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                                                   |#########
#########+----------------------------------------------------------+#########
##############################################################################

See Also: QUIT

Online resources provided by: http://www.X-Hacker.org --- NG 2 HTML conversion by Dave Pearson