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

 onexit()                Register Terminating Function

 #include   <stdlib.h>

 onexit_t   onexit(func);
 onexit_t   func;                        Pointer to function to call on exit

    onexit() registers the address of a function ('func') in the list of
    functions to be called when the calling process terminates normally
    (either by returning from main() or by calling exit()).  onexit() can
    register up to 32 functions, which are executed in a "last-in,
    first-out" order.

    Returns:    'func' if successful; NULL if 32 functions are already
                registered.

      Notes:    _exit() and abort() do not execute functions registered
                with onexit().  Use atexit() if you want ANSI
                compatibility.

                The functions registered with onexit() cannot have
                parameters.  Type 'onexit_t' is defined in <stdlib.h>.

 Portability:   Not supported by ANSI standard.

   -------------------------------- Example ---------------------------------

    The following program prints out "good-bye".

           #include <stdlib.h>

           dash()
           {
               printf("-");
           }

           bye()
           {
               printf("bye\n");
           }

           main()
           {
               onexit(bye);
               onexit(dash);
               printf("Good");
           }