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

 emessage()          Return the message associated with the last error
------------------------------------------------------------------------------
 Declaration
   system.hdr

 Syntax
   func char emessage extern

 Arguments
   None.

 Return
   An error message string.

 Description
   The emessage() function returns the error message associated with the
   last runtime error condition.

   The Force runtime library considers any error entering the runtime error
   system as fatal. The emessage() and imessage() functions are diagnostic.

   If the emessage() function is linked with an application, the resulting
   code size increases by about 3 Kbytes because all text constants
   containing the available error messages are linked as well.

 Example
   #define EXAMPLE_SYSTEM
   #include example.hdr

   //  Have an error procedure print a diagnostic message.
   
   proc ErrorProc
   ? "Runtime error", istr( __errcode )
   ? emessage()
   quit 1
   endproc
   
   proc Test_emessage
   on error do ErrorProc
   pickclear( 0 )        // generate a runtime error
   endproc

   proc main
   Test_emessage()
   endproc